GET

/v1/schemas/fal/video/wan/v2.6/reference-to-video

Accept:

kind inputactivity videohash 079683d7…extracted Aug 10, 2026version currentsource upstream spec ↗

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

Request body

10 properties · 2 required · 0 $defs

property	type	description	constraints
video_urls*	string[]	Reference videos for subject consistency (1-3 videos). Videos' FPS must be at least 16 FPS.Reference in prompt as @Video1, @Video2, @Video3. Works for people, animals, or objects.
prompt*	string	Use @Video1, @Video2, @Video3 to reference subjects from your videos. Works for people, animals, or objects. For multi-shot prompts: '[0-3s] Shot 1. [3-6s] Shot 2.' Max 1500 characters.	length ≥ 1
negative_prompt	string	Negative prompt to describe content to avoid. Max 500 characters.	nullable
seed	integer	Random seed for reproducibility. If None, a random seed is chosen.	nullable
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: true
duration	enum	Duration of the generated video in seconds. R2V supports only 5 or 10 seconds (no 15s).	5 \| 10 · default: "5"
aspect_ratio	enum	The aspect ratio of the generated video.	16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 · default: "16:9"
enable_prompt_expansion	boolean	Whether to enable prompt rewriting using LLM.	default: true
multi_shots	boolean	When true (default), enables intelligent multi-shot segmentation for coherent narrative videos with multiple shots. When false, generates single continuous shot. Only active when enable_prompt_expansion is True.	default: true
resolution	enum	Video resolution tier. R2V only supports 720p and 1080p (no 480p).	720p \| 1080p · default: "1080p"

Validate a payload

before you spend tokens

shell

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