GET

/v1/schemas/fal/image/fal-ai/hunyuan-image/v3/instruct/edit

Accept:

kind inputactivity imagehash f6227086…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `167c7f0c06030f83a438a17cb61362b0aaa67556f195c79c81daceb2e9327e3c` { "fetchedAt": 1783329487, "extractorVersion": "1", "verifiedAt": null }

Request body

10 properties · 2 required · 1 $defs

property	type	description	constraints
prompt*	string	The text prompt to generate an image from.
image_urls*	string[]	The URLs of the images to use as a reference for the generation. A maximum of 3 images are supported.
seed	integer	Random seed for reproducible results. If None, a random seed is used.	nullable
output_format	enum	The format of the generated image.	jpeg \| png · default: "png"
enable_prompt_expansion	boolean	If set to true, the prompt will be expanded through the model's internal recaptioning step.	default: true
image_size	ImageSize \| enum	The desired size of the generated image. If auto, image size will be determined by the model.	default: "auto"
guidance_scale	number	Controls how much the model adheres to the prompt. Higher values mean stricter adherence.	1 < n ≤ 20 · default: 3.5
num_images	integer	The number of images to generate.	1 ≤ n ≤ 4 · default: 1
enable_safety_checker	boolean	If set to true, the safety checker will be enabled.	default: true
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

Types

1 $defs

ImageSizeobject

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 tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/hunyuan-image/v3/instruct/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}