SandBaseSandBase
Start building
Use in agentTencent models

Tencent modelsimage generation api

tencent/hunyuan-image/2.1

Hunyuan Image 2.1 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
The text prompt to generate an image from.
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.
120
Controls how much the model adheres to the prompt. Higher values mean stricter adherence. Range: 1 to 20.
150
Number of denoising steps. Range: 1 to 50.
The format of the generated image. Allowed values: jpeg, png.
Random seed for reproducible results. If None, a random seed is used.
Enable the refiner model for improved image quality.
Enable prompt enhancement for potentially better results.
Idle

Example output — click Run to generate your own

API README

Hunyuan Image

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

Highlights

  • Distinct output behavior. For Hunyuan Image, for Hunyuan Image, create visual work from a required written prompt In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 workflow with seed as a relevant request control; the seed control exposes the corresponding choice in this route; the seed control exposes the corresponding choice in this route.
  • Creative control. For Hunyuan Image, for Hunyuan Image, select one of ten landscape, square, or portrait ratios In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 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.
  • Workflow fit. For Hunyuan Image, for Hunyuan Image, reprompting defaults on, while the refiner defaults off In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 workflow with use refiner as a relevant request control; the use refiner control exposes the corresponding choice in this route; the use refiner control exposes the corresponding choice in this route.
  • Production detail. For Hunyuan Image, for Hunyuan Image, adjust guidance and denoising steps, then reuse a seed for comparison In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 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.

Pricing

ConfigurationPrice
Per request$0.1

When to Use

ScenarioWhy this model fits
Choose Hunyuan ImageUse it when the required deliverable is specifically the image result documented for tencent/hunyuan-image/2.1.
Match the source materialSelect this route when your inputs naturally map to seed, prompt, use_refiner, aspect_ratio.
Use its distinguishing capabilityFor Hunyuan Image, create visual work from a required written prompt In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 workflow with seed as a relevant request control; the seed control exposes the corresponding choice in this route
Plan repeatable productionFor Hunyuan Image, select one of ten landscape, square, or portrait ratios In Hunyuan Image, this capability is applied through the exact tencent/hunyuan-image/2.1 workflow with prompt as a relevant request control; the prompt control exposes the corresponding choice in this route
Confirm cost and deliveryUse the pricing combinations below and the output contract above when budgeting or automating Hunyuan Image jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan-image/2.1 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": "A cute, cartoon-style anthropomorphic penguin plush toy, standing in a painting studio, wearing a red knitted scarf and beret.",
  "seed": 0,
  "use_refiner": false,
  "aspect_ratio": "21:9"
}

Technical Specs

SpecificationValue
Model IDtencent/hunyuan-image/2.1
Execution modeasync
Required inputsprompt
Request fieldsseed (integer, optional); prompt (string, required); use_refiner (boolean, optional); 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); use_reprompt (boolean, optional); output_format (string, optional, options: jpeg / png); guidance_scale (number, optional, min 1, max 20); num_inference_steps (integer, optional, min 1, max 50)
Outputurl (string); content_type (string)

Related Models

Related Models

tencent/hunyuan-image/3.0Hunyuan 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.tencent/hunyuan-image/3.0/editHunyuan Image 3.0 Edit by Tencent - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.tencent/hunyuan-image/3.0/instructHunyuan 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.tencent/hunyuan-3d/3.1/pro/text-to-3dHunyuan 3d 3.1 Pro is Tencent's text-to-3D AI model. Turn written descriptions into textured 3D objects with realistic geometry and materials.tencent/hunyuan-3d/3.1/rapid/image-to-3dHunyuan 3d 3.1 Rapid by Tencent - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.tencent/hunyuan-3d/3.1/rapid/text-to-3dHunyuan 3d 3.1 Rapid is Tencent's text-to-3D AI model. Turn written descriptions into textured 3D objects with realistic geometry and materials.tencent/hunyuan-3d/3.1/smart-topologyHunyuan 3d 3.1 Smart Topology by Tencent - advanced AI model for 3d-to-3d. Delivers high-quality results with fast inference, suitable for both creative and production workflows.tencent/hunyuan-3d/v2Hunyuan 3d V2 is Tencent's image-to-3D AI model. Transform photographs into production-ready 3D meshes with accurate geometry and texture mapping.