GET
/v1/schemas/fal/video/fal-ai/wan-i2v
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracecc62d1a743d1a944b87a167144d61b33f66eebe5b8b6965b3a7542dae82fb07a{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
14 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt to guide video generation. | |
| image_url* | string | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. | |
| guide_scale | number | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. | 1 ≤ n ≤ 10 · default: 5 |
| 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: false |
| num_inference_steps | integer | Number of inference steps for sampling. Higher values give better quality but take longer. | 2 ≤ n ≤ 40 · default: 30 |
| aspect_ratio | enum | Aspect ratio of the generated video. If 'auto', the aspect ratio will be determined automatically based on the input image. | auto | 16:9 | 9:16 | 1:1 · default: "auto" |
| resolution | enum | Resolution of the generated video (480p or 720p). 480p is 0.5 billing units, and 720p is 1 billing unit. | 480p | 720p · default: "720p" |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| shift | number | Shift parameter for video generation. | 1 ≤ n ≤ 10 · default: 5 |
| num_frames | integer | Number of frames to generate. Must be between 81 to 100 (inclusive). If the number of frames is greater than 81, the video will be generated with 1.25x more billing units. | 81 ≤ n ≤ 100 · nullable |
| frames_per_second | integer | Frames per second of the generated video. Must be between 5 to 24. | 5 ≤ n ≤ 24 · nullable |
| negative_prompt | string | Negative prompt for video generation. | default: "bright colors, overexposed, sta… |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. | default: false |
| acceleration | enum | Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'regular'. | none | regular · default: "regular" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/wan-i2v","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}