GET
/v1/schemas/fal/video/fal-ai/wan/v2.2-a14b/video-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace34c1f341b474897c85c314db183aa387c4b2be9ee2f9156f6005c8d19378fa30{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
23 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL of the input video. | |
| 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 |
| 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 |
| 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 video. | 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 |
| resample_fps | boolean | If true, the video will be resampled to the passed frames per second. If false, the video will not be resampled. | default: false |
| 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 |
| strength | number | Strength of the video transformation. A value of 1.0 means the output will be completely based on the prompt, while a value of 0.0 means the output will be identical to the input video. | 0 ≤ n ≤ 1 · default: 0.9 |
| 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: 4 |
| 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" |
| interpolator_model | enum | The model to use for frame interpolation. If None, no interpolation is applied. | none | film | rife · default: "film" |
| 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" |
| 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 |
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/video-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}