GET

/v1/schemas/fal/video/fal-ai/vidu/q2/image-to-video/pro

Accept:

kind inputactivity videohash 4ada9a5b…extracted Oct 23, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `8ab2b357dc1c59ea15f99fa504c878242641894c817f232c39fbf891be360d32` { "fetchedAt": 1792731610, "extractorVersion": "1", "verifiedAt": null }

Request body

9 properties · 2 required · 0 $defs

property	type	description	constraints
prompt*	string	Text prompt for video generation, max 3000 characters	length ≤ 3000
image_url*	string	URL of the image to use as the starting frame
end_image_url	string	URL of the image to use as the ending frame. When provided, generates a transition video between start and end frames.	nullable
resolution	enum	Output video resolution	720p \| 1080p · default: "720p"
bgm	boolean	Whether to add background music to the video (only for 4-second videos)	default: false
movement_amplitude	enum	The movement amplitude of objects in the frame	auto \| small \| medium \| large · default: "auto"
duration	enum	Duration of the video in seconds	2 \| 3 \| 4 \| 5 \| 6 \| 7 · +1 more · default: 4
seed	integer	Random seed for reproducibility. If None, a random seed is chosen.	nullable
enable_safety_checker	boolean	Enable safety checks; disabling requires authorization.	nullable

Validate a payload

before you spend tokens

shell

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