LogoAPI in One
🏔️

Hunyuan Image 3 API

active

Hunyuan Image 3 Instruct — Tencent's advanced text-to-image and image editing model. 25 credits per image with seed-based reproducibility.

Tencent / WaveSpeedimage25 credits/call
Provider
Tencent / WaveSpeed
Pricing
~$0.05 per image (25 credits)
Speed
5–15 seconds
Output
image

Quick Start

Send a request to the Hunyuan Image 3 API:

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hunyuan-image-3",
  "prompt": "A traditional Chinese garden with cherry blossoms and a koi pond, watercolor style",
  "type": "text-to-image",
  "size": "1024*1024"
}'

API Endpoint

POST/api/v1/images/generations
Send a POST request with your API key to generate content using Hunyuan Image 3.

Headers

Header类型必填描述
Authorizationstring必填Bearer YOUR_API_KEY
Content-Typestring必填application/json

Body Parameters

参数类型必填描述
modelstring必填Model identifier: "hunyuan-image-3"
promptstring必填Text description of the image (max 2000 chars)
typestring可选Generation type: "text-to-image" or "edit" (默认值: text-to-image)
sizestring可选Image size (e.g. "1024*1024") (默认值: 1024*1024)
imagesarray可选Array of image URLs for edit mode (max 2, required when type is "edit")
seednumber可选Random seed for reproducibility (-1 for random) (默认值: -1)

Example Request

json
{
  "model": "hunyuan-image-3",
  "prompt": "A traditional Chinese garden with cherry blossoms and a koi pond, watercolor style",
  "type": "text-to-image",
  "size": "1024*1024"
}

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n68xxxx_hunyuan3",
    "status": "IN_PROGRESS"
  }
}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}
Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

Use Cases

  • ✓Generate high-fidelity images from text descriptions
  • ✓Edit existing images with text instructions
  • ✓Create product imagery with Tencent-grade quality
  • ✓Build AI-powered image editing workflows

API Tester

Test the Hunyuan Image 3 API directly from your browser:

API 测试沙盒POST

Error Codes

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

Frequently Asked Questions

How much does Hunyuan Image 3 cost?

Each image costs 25 credits (~$0.05) for both text-to-image and edit modes.

Does Hunyuan Image 3 support image editing?

Yes. Set type to "edit" and provide images (up to 2) alongside your text prompt for editing.

Does it support seed-based reproducibility?

Yes. Set the seed parameter to reproduce specific results.

Why Use Hunyuan Image 3 Through API in One?

1Tencent's state-of-the-art image model
2Both text-to-image and image editing
3Seed-based reproducibility
4Instruction-following image generation

Ready to use Hunyuan Image 3?

Get Your API Key →