GET
/v1/schemas/fal/video/alibaba/wan-3.0/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traced47ae22548fe7106b037a91416308d322c62dbbf8d5377de803895196206bc1c{
"fetchedAt": 1790830869,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
14 properties · 0 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| web_url | string | Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read. | nullable |
| enable_prompt_expansion | boolean | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. | default: true |
| audio | boolean | Include generated audio. | default: true |
| reference_audio_urls | string[] | Up to 5 reference audio URLs totaling at most 15 seconds. | items ≤ 5 |
| aspect_ratio | enum | Output aspect ratio, or adaptive selection. | adaptive | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 · default: "adaptive" |
| seed | integer | 0 ≤ n ≤ 2147483647 · nullable | |
| enable_thinking | boolean | Enable enhanced reasoning before generation. | default: false |
| reference_image_urls | string[] | Up to 10 reference image URLs. | items ≤ 10 |
| duration | integer | Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media. | 2 ≤ n ≤ 30 · nullable |
| file_url | string | Document URL to base the video on. Requires enable_thinking=true. | nullable |
| enable_safety_checker | boolean | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. | default: true |
| resolution | enum | Output video resolution tier. | 480p | 720p | 1080p · default: "1080p" |
| prompt | string | Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'. | length ≤ 20000 · nullable |
| reference_video_urls | string[] | Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. Input video duration is billed in addition to output duration. | items ≤ 5 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"alibaba/wan-3.0/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}