Image Generation
Hunyuan Image 3 API
Hunyuan Image 3.0 — Tencent's 80B-parameter MoE text-to-image model. High-fidelity generation with seven aspect ratio presets and a fast mode toggle. Integrate this model via REST with endpoint docs, parameters, and code examples.
Get API Key
Create auth keys for apps and agents
See Usage
Track requests, credits, and logs
Buy Credits
Top up prepaid API capacity
API Endpoint
/api/v1/models/hunyuan-image-3/runTest This Model
Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.
LLM.txt
For AI assistants
Copy this model's documentation into Claude, GPT, or any AI for instant integration help.
/llm/hunyuan-image-3.txtOpenAPI Spec
Swagger compatible
Import into Postman, Swagger UI, or generate client SDKs in any language.
/api/openapiParameters
Input parameters accepted by this model
| Parameter | Type | Default |
|---|---|---|
promptrequired | string | - |
negative_prompt | string | - |
aspect_ratio | enum | 1:1 |
go_fast | boolean | true |
seed | integer | - |
Use saved characters (@Name)
@Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.Supported Aspect Ratios
Example Outputs
Real outputs generated by this model
A misty bamboo forest path at dawn, soft green light filtering through tall stalks, tranquil, crisp nature photography
A misty mountain valley at dawn, layered ridgelines, a winding river through pine forest, soft light
A delicate hummingbird hovering beside a trumpet flower, iridescent feathers, crisp macro photography
A playful golden retriever leaping into a lake to fetch a stick, water splashing, sunny summer day
A dramatic desert landscape with towering red rock arches under a star-filled night sky, long exposure
A charming Parisian cafe corner with a striped awning and flowers, cobblestone street, soft morning light
A vibrant coral reef alive with tropical fish and a sea turtle, crystal-clear water, sun rays underwater
A vintage typewriter on a desk beside a steaming coffee and an open notebook, warm cinematic lighting
A surreal floating island with waterfalls spilling into the clouds, fantasy landscape, golden light
A snow-dusted log cabin glowing warmly in a pine forest at twilight, smoke from the chimney, peaceful
A detailed steaming bowl of ramen with fresh herbs and a soft egg, overhead shot, appetizing food photography
A field of vibrant tulips stretching to a windmill on the horizon, bright blue sky, Dutch countryside
A retro 1960s diner at dusk, neon signs glowing, classic cars parked outside, nostalgic warm tones
A curious orange tabby kitten peeking out of a wicker basket, soft window light, adorable detail
A powerful waterfall cascading through a lush green canyon, mist catching rainbow light, wide landscape
A rustic loaf of crusty bread and a glass of red wine on a wooden table, candlelit, moody food photography
A whimsical hot air balloon shaped like a whale floating over rolling green hills, dreamy pastel sky
An elegant modern living room with floor-to-ceiling windows overlooking a misty forest, warm natural light
A lone red sailboat on a calm turquoise sea at golden hour, minimalist composition, gentle reflections
A close-up of a bee collecting pollen from a sunflower, wings mid-flutter, macro detail, soft bokeh
A majestic snow leopard resting on a rocky Himalayan ledge, piercing eyes, crisp wildlife photography
A vibrant street food market at night, glowing lanterns and sizzling woks, rich atmospheric color
A serene Japanese tea garden in spring, cherry blossoms drifting over a koi pond, soft morning light, highly detailed
A cozy attic art studio bathed in afternoon sun, canvases and brushes everywhere, warm dust motes in the light
Code Examples
Text → image — copy and paste to get started
curl -X POST "https://pixeldojo.ai/api/v1/models/hunyuan-image-3/run" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A snowy mountain village at dawn, painterly, fine detail",
"aspect_ratio": "1:1"
}'Response Format
Submit Response (202 Accepted)
{
"jobId": "job_abc123...",
"status": "pending",
"statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
"creditCost": 2,
"creditsRemaining": 95,
"expiresAt": "2026-10-10T02:51:01Z"
}Completed Response
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 2,
"expiresAt": "2026-10-10T02:51:01Z"
}