GET

/v1/schemas/fal/video/fal-ai/wan/v2.2-5b/image-to-video

Accept:

kind inputactivity videohash 553beac9…extracted Aug 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `c0c710ddfb75049dccdad2192f440433dcb3b044561d4fe8d912f25bb969d70f` { "fetchedAt": 1786338105, "extractorVersion": "1", "verifiedAt": null }

Request body

19 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: 0
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: ""
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"
num_frames	integer	Number of frames to generate. Must be between 17 to 161 (inclusive).	17 ≤ n ≤ 161 · default: 81
shift	number	Shift value for the video. Must be between 1.0 and 10.0.	1 ≤ n ≤ 10 · default: 5
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 ≤ 50 · default: 40
resolution	enum	Resolution of the generated video (580p or 720p).	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
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"
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 tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/wan/v2.2-5b/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}