Hunyuan Image 3 API

Open-source text-to-image model on a multimodal Mixture-of-Experts architecture with photorealistic detail and strong multilingual text rendering.

TencentImage GenerationProprietary Endpoint

About Hunyuan Image 3

Open-source text-to-image model on a multimodal Mixture-of-Experts architecture with photorealistic detail and strong multilingual text rendering.

photorealisticmultilingual

Hunyuan Image 3 specs

Model ID
hunyuan-image-3
Provider
Tencent
Category
Image Generation
Input
text
Output
image
Endpoints
POST /v1/images/generations

Hunyuan Image 3 API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

Type
Spec
Rate
Standard
per image
$0.13
Compare on the full pricing page

How to call the Hunyuan Image 3 API

Hunyuan Image 3 runs through POST /v1/images/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Or add "sync": true to skip polling: the request stays open and returns the finished OpenAI-style image response directly, so OpenAI SDKs work as-is. Get an API key from the EmpirioLabs dashboard.

cURL: submit the job
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hunyuan-image-3",
    "prompt": "Describe what you want Hunyuan Image 3 to generate."
  }'
cURL: poll for the result
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "hunyuan-image-3",
        "prompt": "Describe what you want Hunyuan Image 3 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Full Hunyuan Image 3 API reference

Hunyuan Image 3 API parameters

Request parameters supported by the Hunyuan Image 3 API on EmpirioLabs. Defaults apply when a field is omitted.

ParameterTypeDefaultRange / valuesDescription
promptstring--Text prompt.
sizeenum1024x10241024x1024, 768x1024, 1024x768, 1024x1536, 1536x1024, 512x512Output resolution. Square, portrait, and landscape presets.
num_imagesnumber11 to 4Number of images to generate. Each is billed separately.
negative_promptstring--What to avoid in the output.
num_inference_stepsnumber2810 to 50Diffusion steps. More = higher fidelity, slower.
guidance_scalenumber7.51 to 20Classifier-free guidance. Higher = follows prompt more strictly.
seednumber--Reproducibility seed.
response_formatenumurlurl, b64_jsonurl (default) returns a signed URL; b64_json returns inline base64.

Good to know

Diffusion image model with configurable steps and guidance scale.

Hunyuan Image 3 API: common questions

How much does the Hunyuan Image 3 API cost?

On EmpirioLabs, Hunyuan Image 3 is billed pay as you go: Standard $0.13 per image. The live rate card on this page always matches what the API charges.

Which endpoint does Hunyuan Image 3 use?

Hunyuan Image 3 is served through POST /v1/images/generations on api.empiriolabs.ai with standard bearer-token authentication.

Can I try Hunyuan Image 3 in the browser before integrating?

Yes. The EmpirioLabs playground runs Hunyuan Image 3 in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Hunyuan Image 3 API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make.

Ready to use better endpoints?

Explore our models, or contact us about business inquiries, custom deployments, or anything else.