GET

/v1/schemas/fal/video/fal-ai%2Fhunyuan-video-v1.5%2Fimage-to-video

kind inputactivity videohash a5a89ba4extracted Jul 6, 2026version currentsource upstream spec ↗

Request body

9 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
image_url*stringURL of the reference image for image-to-video generation.
prompt*stringThe prompt to generate the video from.
num_inference_stepsintegerThe number of inference steps.1 ≤ n ≤ 50 · default: 28
num_framesintegerThe number of frames to generate.1 ≤ n ≤ 121 · default: 121
aspect_ratioenumThe aspect ratio of the video.16:9 | 9:16 · default: "16:9"
negative_promptstringThe negative prompt to guide what not to generate.default: ""
resolutionconstThe resolution of the video."480p" · default: "480p"
seedintegerRandom seed for reproducibility.nullable
enable_prompt_expansionbooleanEnable prompt expansion to enhance the input prompt.default: true

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/hunyuan-video-v1.5/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}