🏔️Image APIActive

hunyuan-image-3 API

Generate and edit images with Tencent's Hunyuan Image 3 Instruct via API in One. Text-to-image and image editing. 25 credits per image (~$0.25).

Get API Key View Docs

Model IDhunyuan-image-3

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text, image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

This route does not require webhook handling.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

Tencent's state

Tencent's state-of-the-art image model

Both text

Both text-to-image and image editing

Seed

Seed-based reproducibility

Instruction

Instruction-following image generation

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/images/generations25 credits

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

Parameters

promptstring

Text description of the image (max 2000 chars)

Required

typestring

Generation type: "text-to-image" or "edit"

Optional · Default text-to-image

sizestring

Image size (e.g. "1024*1024")

Optional · Default 1024*1024

imagesarray

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

Optional

seednumber

Random seed for reproducibility (-1 for random)

Optional · Default -1

Example request

curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "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"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

🧠cogview-4image · 4 credits/api/v1/images/generations

flux-2image · 5 credits/api/v1/images/generations

grok-imagineimage · 5 credits/api/v1/images/generations

kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generations

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

~$0.25 per image (25 credits)

Base cost$0.25

Credits25

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

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

FAQ

How much does Hunyuan Image 3 cost?

Each image costs 25 credits (~$0.25) 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.