tencent/hunyuan-image/3.0

Name: Hunyuan Image 3.0
Author: Tencent

Hunyuan Image 3.0 is Tencent's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.

Input

Prompt(string)

The text prompt for image-to-image.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtencent/hunyuan-image/3.0

Input Schema

3 parameters · 1 required · 2 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt for image-to-image.
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "tencent/hunyuan-image/3.0",
  "prompt": "200mm telephoto through crowd gaps; subject laughing, candid; creamy background compression, color pop from a single bold garment, catchlight in eyes.",
  "output_format": "png"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Hunyuan Image 3.0

API README

Hunyuan Image 3.0

Hunyuan Image 3.0 occupies a clearly bounded position in a image production pipeline under the route tencent/hunyuan-image/3.0. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.

A practical rollout of Hunyuan Image 3.0 should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final 3.0 deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity tencent/hunyuan-image/3.0.

Highlights

Distinct output behavior. For Hunyuan Image 3.0, for Hunyuan Image 3.0, translate a natural-language visual brief into an image In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow with prompt as a relevant request control; the prompt control exposes the corresponding choice in this route; the prompt control exposes the corresponding choice in this route.
Creative control. For Hunyuan Image 3.0, for Hunyuan Image 3.0, frame the result from 21:9 to 9:16 In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow with aspect ratio as a relevant request control; the aspect ratio control exposes the corresponding choice in this route; the aspect ratio control exposes the corresponding choice in this route.
Workflow fit. For Hunyuan Image 3.0, for Hunyuan Image 3.0, keep PNG output or switch to JPEG In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow with output format as a relevant request control; the output format control exposes the corresponding choice in this route; the output format control exposes the corresponding choice in this route.
Production detail. For Hunyuan Image 3.0, for Hunyuan Image 3.0, work with prompt, aspect ratio, and output-format controls In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow.

Pricing

Configuration	Price
Per request	$0.1

When to Use

Scenario	Why this model fits
Choose Hunyuan Image 3.0	Use it when the required deliverable is specifically the image result documented for `tencent/hunyuan-image/3.0`.
Match the source material	Select this route when your inputs naturally map to `prompt`, `aspect_ratio`, `output_format`.
Use its distinguishing capability	For Hunyuan Image 3.0, translate a natural-language visual brief into an image In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow with prompt as a relevant request control; the prompt control exposes the corresponding choice in this route
Plan repeatable production	For Hunyuan Image 3.0, frame the result from 21:9 to 9:16 In Hunyuan Image 3.0, this capability is applied through the exact tencent/hunyuan-image/3.0 workflow with aspect ratio as a relevant request control; the aspect ratio control exposes the corresponding choice in this route
Confirm cost and delivery	Use the pricing combinations below and the output contract above when budgeting or automating Hunyuan Image 3.0 jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan-image/3.0 schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.

{
  "prompt": "200mm telephoto through crowd gaps; subject laughing, candid; creamy background compression, color pop from a single bold garment, catchlight in eyes.",
  "aspect_ratio": "21:9",
  "output_format": "png"
}

Technical Specs

Specification	Value
Model ID	`tencent/hunyuan-image/3.0`
Execution mode	`async`
Required inputs	`prompt`
Request fields	`prompt` (string, required); `aspect_ratio` (string, optional, options: 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16); `output_format` (string, optional, options: jpeg / png)
Output	`url` (string); `content_type` (string)