GET
/v1/schemas/fal/video/fal-ai%2Feditto
Accept:
Request body
23 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt to guide video generation. | |
| video_url* | string | URL to the source video file. Required for inpainting. | |
| return_frames_zip | boolean | If true, also return a ZIP file containing all generated frames. | default: false |
| guidance_scale | number | Guidance scale for classifier-free guidance. Higher values encourage the model to generate images closely related to the text prompt. | 1 ≤ n ≤ 10 · default: 5 |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. | default: false |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| num_frames | integer | Number of frames to generate. Must be between 81 to 241 (inclusive). | 17 ≤ n ≤ 241 · default: 81 |
| frames_per_second | integer | Frames per second of the generated video. Must be between 5 to 30. Ignored if match_input_frames_per_second is true. | 5 ≤ n ≤ 30 · nullable |
| match_input_frames_per_second | boolean | If true, the frames per second of the generated video will match the input video. If false, the frames per second will be determined by the frames_per_second parameter. | default: false |
| sampler | enum | Sampler to use for video generation. | unipc | dpm++ | euler · default: "unipc" |
| aspect_ratio | enum | Aspect ratio of the generated video. | auto | 16:9 | 1:1 | 9:16 · default: "auto" |
| 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 |
| shift | number | Shift parameter for video generation. | 1 ≤ n ≤ 15 · default: 5 |
| acceleration | enum | Acceleration to use for inference. Options are 'none' or 'regular'. Accelerated inference will very slightly affect output, but will be significantly faster. | none | low | regular · nullable |
| num_inference_steps | integer | Number of inference steps for sampling. Higher values give better quality but take longer. | 2 ≤ n ≤ 50 · default: 30 |
| enable_auto_downsample | boolean | If true, the model will automatically temporally downsample the video to an appropriate frame length for the model, then will interpolate it back to the original frame length. | default: false |
| video_quality | enum | The quality of the generated video. | low | medium | high | maximum · default: "high" |
| negative_prompt | string | Negative prompt for video generation. | default: "letterboxing, borders, black ba… |
| resolution | enum | Resolution of the generated video. | auto | 240p | 360p | 480p | 580p | 720p · default: "auto" |
| match_input_num_frames | boolean | If true, the number of frames in the generated video will match the number of frames in the input video. If false, the number of frames will be determined by the num_frames parameter. | default: false |
| video_write_mode | enum | The write mode of the generated video. | fast | balanced | small · default: "balanced" |
| num_interpolated_frames | integer | Number of frames to interpolate between the original frames. A value of 0 means no interpolation. | 0 ≤ n ≤ 5 · default: 0 |
| temporal_downsample_factor | integer | Temporal downsample factor for the video. This is an integer value that determines how many frames to skip in the video. A value of 0 means no downsampling. For each downsample factor, one upsample factor will automatically be applied. | 0 ≤ n ≤ 5 · default: 0 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/editto","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}