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
1curl -X POST https://apiin.one/api/v1/images/generations \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "hunyuan-image-3",
6 "prompt": "A traditional Chinese garden with cherry blossoms and a koi pond, watercolor style",
7 "type": "text-to-image",
8 "size": "1024*1024"
9}'

API Endpoint

POST/api/v1/images/generations

Send a POST request with your API key to generate content using Hunyuan Image 3.

Headers

Body ParametersJSON
Authorization:string

Bearer YOUR_API_KEY

Content-Type:string

application/json

Body Parameters

Body ParametersJSON
model:string

Model identifier: hunyuan-image-3

prompt:string

Text description of the image (max 2000 chars)

type:optional string

Generation type: text-to-image or edit Defaults to text-to-image.

size:optional string

Image size (e.g. 1024*1024) Defaults to 1024*1024.

images:optional array

Array of image URLs for edit mode (max 2, required when type is edit)

seed:optional number

Random seed for reproducibility (-1 for random) Defaults to -1.

Example Request

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

Example Response

Successful task creation response.

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n68xxxx_hunyuan3",
6 "status": "IN_PROGRESS"
7 }
8}

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
1curl https://apiin.one/api/v1/tasks/task_abc123 \
2 -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:

Consola de APIPOST

Error Codes

1{
2 "error": {
3 "code": 400,
4 "message": "Invalid parameters",
5 "type": "invalid_request"
6 }
7}

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?

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

Ready to use Hunyuan Image 3?

Get Your API Key →