GET
/v1/schemas/fal/image/fal-ai/hunyuan-image/v2.1/text-to-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace1c7031c2e2c52a949028d4d27c68c46e35f444e1137dcd73c1aad5eaebcf4893{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt to generate an image from. | |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. | default: false |
| output_format | enum | The format of the generated image. | jpeg | png · default: "png" |
| use_reprompt | boolean | Enable prompt enhancement for potentially better results. | default: true |
| use_refiner | boolean | Enable the refiner model for improved image quality. | default: false |
| num_inference_steps | integer | Number of denoising steps. | 1 ≤ n ≤ 50 · default: 28 |
| seed | integer | Random seed for reproducible results. If None, a random seed is used. | nullable |
| negative_prompt | string | The negative prompt to guide the image generation away from certain concepts. | default: "" |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked. | default: true |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| guidance_scale | number | Controls how much the model adheres to the prompt. Higher values mean stricter adherence. | 1 ≤ n ≤ 20 · default: 3.5 |
| image_size | ImageSize | enum | The desired size of the generated image. | default: "square_hd" |
Types
1 $defsImageSizeobject
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/hunyuan-image/v2.1/text-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}