GET
/v1/schemas/fal/video/fal-ai/wan/v2.2-a14b/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracea4ee7cebc84b53012b94103426b174466ed476637fd45b18087f06387490a4a9{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
22 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| 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. | |
| prompt* | string | The text prompt to guide video generation. | |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. | default: false |
| num_interpolated_frames | integer | Number of frames to interpolate between each pair of generated frames. Must be between 0 and 4. | 0 ≤ n ≤ 4 · default: 1 |
| enable_safety_checker | boolean | If set to true, input data will be checked for safety before processing. Disabling it requires account authorization; unauthorized requests are always checked. | default: false |
| adjust_fps_for_interpolation | boolean | If true, the number of frames per second will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If false, the p… | default: true |
| negative_prompt | string | Negative prompt for video generation. | default: "" |
| 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" |
| 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" |
| shift | number | Shift value for the video. Must be between 1.0 and 10.0. | 1 ≤ n ≤ 10 · default: 5 |
| interpolator_model | enum | The model to use for frame interpolation. If None, no interpolation is applied. | none | film | rife · default: "film" |
| num_frames | integer | Number of frames to generate. Must be between 17 to 161 (inclusive). | 17 ≤ n ≤ 161 · default: 81 |
| enable_output_safety_checker | boolean | If set to true, output video will be checked for safety after generation. | default: false |
| num_inference_steps | integer | Number of inference steps for sampling. Higher values give better quality but take longer. | 2 ≤ n ≤ 40 · default: 27 |
| resolution | enum | Resolution of the generated video (480p, 580p, or 720p). | 480p | 580p | 720p · default: "720p" |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| frames_per_second | integer | Frames per second of the generated video. Must be between 4 to 60. When using interpolation and `adjust_fps_for_interpolation` is set to true (default true,) the final FPS will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If `adjust_fps_for_interpolation` is set to false, this value will be used as-is. | 4 ≤ n ≤ 60 · nullable |
| guidance_scale_2 | number | Guidance scale for the second stage of the model. This is used to control the adherence to the prompt in the second stage of the model. | 1 ≤ n ≤ 10 · default: 3.5 |
| video_quality | enum | The quality of the output video. Higher quality means better visual quality but larger file size. | low | medium | high | maximum · default: "high" |
| end_image_url | string | URL of the end image. | nullable |
| video_write_mode | enum | The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between speed and quality, and small write mode is the slowest but produces the smallest file size. | fast | balanced | small · default: "balanced" |
| guidance_scale | number | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. | 1 ≤ n ≤ 10 · default: 3.5 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/wan/v2.2-a14b/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}