Hunyuan Image 3.0 Instruct

Name: Tencent Hunyuan Image 3.0 Instruct
Price: 0.09 USD
Availability: InStock
Author: Tencent

tencent/hunyuan-image/3.0/instruct

Hunyuan Image 3.0 Instruct by Tencent - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

Use in agent Get API key

Base price: $0.09USD / run
Execution: async
Model type: image
Input fields: 3

Try the model

Playground

Open playground

Input

Prompt(string)

The text prompt to generate an image from.

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.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.09 / run

Context & modalities

Input: Schema-defined
Output: image

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Tencent
Model ID: tencent/hunyuan-image/3.0/instruct
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Hunyuan Image 3.0 Instruct

Hunyuan Image 3.0 Instruct occupies a clearly bounded position in a image production pipeline under the route tencent/hunyuan-image/3.0/instruct. 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 Instruct should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final instruct 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/instruct.

Highlights

Distinct output behavior. For Hunyuan Image 3.0 Instruct, for Hunyuan Image 3.0 Instruct, supply a prompt that describes the image to generate In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct 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 Instruct, for Hunyuan Image 3.0 Instruct, select from ten documented aspect ratios In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct 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 Instruct, for Hunyuan Image 3.0 Instruct, available ratios run from 21:9 through 9:16 In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct 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 Instruct, for Hunyuan Image 3.0 Instruct, deliver the result in PNG or JPEG form In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct workflow.

Pricing

Configuration	Price
Per request	$0.09

When to Use

Scenario	Why this model fits
Choose Hunyuan Image 3.0 Instruct	Use it when the required deliverable is specifically the image editing result documented for `tencent/hunyuan-image/3.0/instruct`.
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 Instruct, supply a prompt that describes the image to generate In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct 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 Instruct, select from ten documented aspect ratios In Hunyuan Image 3.0 Instruct, this capability is applied through the exact tencent/hunyuan-image/3.0/instruct 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 Instruct jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan-image/3.0/instruct 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": "Macro photograph of a peacock feather showing individual barbs, barbules, and the iridescent microstructure creating color.",
  "aspect_ratio": "21:9",
  "output_format": "png"
}

Technical Specs

Specification	Value
Model ID	`tencent/hunyuan-image/3.0/instruct`
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)

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

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

Model ID

tencent/hunyuan-image/3.0/instruct

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "tencent/hunyuan-image/3.0/instruct",
  "prompt": "Macro photograph of a peacock feather showing individual barbs, barbules, and the iridescent microstructure creating color.",
  "output_format": "png"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
Hunyuan Image 3.0 InstructThis model `Tencent`	Image	$0.09 / run	Jan 28, 2026
Hunyuan Image 3.0 Edit `Tencent`	Image	$0.45 / run	Jan 28, 2026
Hunyuan 3D 3.1 Pro Text to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.1 Pro Image to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.0 Image to 3D `Tencent`	Image	$0.63 / run	Dec 16, 2025
Hunyuan Image 3.0 Text to Image `Tencent`	Image	$0.10 / run	Sep 28, 2025

Questions

FAQ

How do I call Tencent Hunyuan Image 3.0 Instruct through SandBase?

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-image/3.0/instruct" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Tencent account?

No. One SandBase API key and balance gives you access to Tencent Hunyuan Image 3.0 Instruct and the other models in the catalog; you do not need to sign up with Tencent separately.