GET

/v1/schemas/fal/video/fal-ai/veo3.1/reference-to-video

Accept:

kind inputactivity videohash 6e2f3f97…extracted Jul 6, 2026version currentsource upstream spec ↗

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

Request body

8 properties · 2 required · 0 $defs

property	type	description	constraints
prompt*	string	The text prompt describing the video you want to generate	length ≤ 20000
image_urls*	string[]	URLs of the reference images to use for consistent subject appearance
aspect_ratio	enum	The aspect ratio of the generated video.	16:9 \| 9:16 · default: "16:9"
duration	const	The duration of the generated video.	"8s" · default: "8s"
auto_fix	boolean	Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.	default: false
resolution	enum	The resolution of the generated video.	720p \| 1080p \| 4k · default: "720p"
safety_tolerance	enum	The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.	1 \| 2 \| 3 \| 4 \| 5 \| 6 · default: "4"
generate_audio	boolean	Whether to generate audio for the video.	default: true

Validate a payload

before you spend tokens

shell

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