Skip to main content
Model ID 
hunyuan-image-to-image
Calling method: sync

​
Tencent Hunyuan Image-to-Image API Documentation

​
Overview

Tencent Cloud’s Hunyuan AI Art Image-to-Image model allows users to edit, restyle, or transform an existing image based on textual prompts. It supports detailed positive and negative text guidance to ensure the generated output aligns with user intentions.

​
Authentication

All API requests require authentication using your API key. Include it in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Submit Image-to-Image Request

​
Base URL

https://console.gmicloud.ai

​
Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

​
Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hunyuan-image-to-image",
    "payload": {
      "image": "https://example.com/source_image.jpg",
      "prompt": "Turn the landscape into a snowy winter scene, highly detailed.",
      "negative_prompt": "people, animals, blurry, distorted"
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefault
imagestringYesInput image to be edited.null
promptstringNoText description or editing instruction.""
negative_promptstringNoWhat to avoid in the generated image.""

​
Response

{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "hunyuan-image-to-image",
  "status": "queued",
  "created_at": 1772184500
}

​
Check Request Status

​
Endpoint

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

​
Response

{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "hunyuan-image-to-image",
  "status": "success",
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-assets/.../hunyuan_output_0.jpg"
      }
    ]
  }
}

​
Request Status Values

StatusDescription
queuedRequest is waiting in the queue
processingImage is currently being generated
successImage generation completed
failedGeneration failed (check logs for details)
cancelledRequest was manually cancelled

​
Pricing

  • Pricing Type: Per generation
  • Price: $0.08 per generation