Start building ›
Use in agentTencent models

Tencent modelsimage generation api

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.

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.
The format of the generated image. Allowed values: jpeg, png.
Idle

Example output — click Run to generate your own

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

ConfigurationPrice
Per request$0.09

When to Use

ScenarioWhy this model fits
Choose Hunyuan Image 3.0 InstructUse it when the required deliverable is specifically the image editing result documented for tencent/hunyuan-image/3.0/instruct.
Match the source materialSelect this route when your inputs naturally map to prompt, aspect_ratio, output_format.
Use its distinguishing capabilityFor 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 productionFor 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 deliveryUse 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

SpecificationValue
Model IDtencent/hunyuan-image/3.0/instruct
Execution modeasync
Required inputsprompt
Request fieldsprompt (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)
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/2.1Hunyuan 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.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.