Hunyuan Image V3

hunyuan-image-v3-text-to-image

post

Leverage the state-of-the-art capabilities of Hunyuan Image 3.0 to generate visual content that effectively conveys the messaging of your written material.

Header parameters

AuthorizationstringRequiredExample: sk-yOm1Vc3raDjQluBttyAwSdbVxtWFEAPCbtAZ2uF3yST1xNCY

Body

application/json

modelstringRequired

model is the model name

Example: hunyuan-image-v3-text-to-image

promptstringRequired

prompt is the prompt.

Example: A cute baby sea otter.

sizestring · enumOptional

The size of the generated image. Default value: square_hd

Possible enum values: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9

Note: For custom image sizes, you can pass the width and height as an object:

"image_size": {
  "width": 1280,
  "height": 720
}

Default: square_hdExample: square_hdPossible values:

negative_promptstring | nullOptional

The negative prompt to guide the image generation away from certain concepts. Default value: ""

num_inference_stepsintegerOptional

The number of inference steps to perform. Default value: 28

Default: 28Example: 28

guidance_scalenumberOptional

The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Default value: 7.5

Default: 7.5Example: 7.5

enable_prompt_expansionbooleanOptional

Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.

seedintegerOptional

The same seed and the same prompt given to the same version of the model will output the same image every time.

enable_safety_checkerbooleanOptional

If set to true, the safety checker will be enabled. Default value: false

Default: false

nintegerOptional

n is the number of images to generate, default value is 1.

Default: 1Example: 1

output_formatstring · enumOptional

output_format indicate the output format, default value is url.

Default: urlExample: urlPossible values:

Responses

200Success

application/json

post

/v1/images/generations

HTTPcURLJavaScriptPython

POST /v1/images/generations HTTP/1.1
Host: image.onerouter.pro
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "model": "hunyuan-image-v3-text-to-image",
  "prompt": "A cute baby sea otter.",
  "size": "square_hd",
  "negative_prompt": "",
  "num_inference_steps": 28,
  "guidance_scale": 7.5,
  "enable_prompt_expansion": false,
  "seed": 53,
  "enable_safety_checker": true,
  "n": 1,
  "output_format": "url"
}

200Success

{
  "data": [
    {
      "url": "https://resource.onerouter.pro/image/generated%2Fonerouter_9dbcdc18-0108-428d-b8f0-ddab416c666c.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ],
  "created": 1760773446
}