GET
/v1/schemas/fal/video/fal-ai/wan-22-vace-fun-a14b/inpainting
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace8f6d96879dcb2152e6bf4de5b9395892394cf08182afa5cc7115efe776ab5052{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
33 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. | |
| ref_image_urls | string[] | Urls to source reference image. If provided, the model will use this image as reference. | |
| 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 |
| negative_prompt | string | Negative prompt for video generation. | default: "letterboxing, borders, black ba… |
| 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 |
| first_frame_url | string | URL to the first frame of the video. If provided, the model will use this frame as a reference. | nullable |
| 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" |
| 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 |
| last_frame_url | string | URL to the last frame of the video. If provided, the model will use this frame as a reference. | nullable |
| auto_downsample_min_fps | number | The minimum frames per second to downsample the video to. This is used to help determine the auto downsample factor to try and find the lowest detail-preserving downsample factor. The default value is appropriate for most videos, if you are using a video with … | 1 ≤ n ≤ 60 · default: 15 |
| mask_image_url | string | URL to the guiding mask file. If provided, the model will use this mask as a reference to create masked video using salient mask tracking. Will be ignored if mask_video_url is provided. | nullable |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. | default: false |
| shift | number | Shift parameter for video generation. | 1 ≤ n ≤ 15 · default: 5 |
| num_inference_steps | integer | Number of inference steps for sampling. Higher values give better quality but take longer. | 2 ≤ n ≤ 50 · default: 30 |
| transparency_mode | enum | The transparency mode to apply to the first and last frames. This controls how the transparent areas of the first and last frames are filled. | content_aware | white | black · default: "content_aware" |
| aspect_ratio | enum | Aspect ratio of the generated video. | auto | 16:9 | 1:1 | 9:16 · default: "auto" |
| 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 |
| sampler | enum | Sampler to use for video generation. | unipc | dpm++ | euler · default: "unipc" |
| mask_video_url | string | URL to the source mask file. Required for inpainting. | nullable |
| 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 |
| 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 |
| interpolator_model | enum | The model to use for frame interpolation. Options are 'rife' or 'film'. | rife | film · default: "film" |
| 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 |
| 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 |
| 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 |
| return_frames_zip | boolean | If true, also return a ZIP file containing all generated frames. | default: false |
| preprocess | boolean | Whether to preprocess the input video. | default: false |
| 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 |
| video_quality | enum | The quality of the generated video. | low | medium | high | maximum · default: "high" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/wan-22-vace-fun-a14b/inpainting","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}