GET
/v1/schemas/fal/video/fal-ai/vidu/q4/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace54c46f3d1375b2a680182a2b20449c7e8731d3d2680a3bc176de9a02e2e315d3{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text prompt for video generation, max 5000 characters. Refer to references by their position in the lists: [@reference_image_1], [@reference_image_2], ... for images and [reference_audio_1], [reference_audio_2], ... for audio clips. | length ≥ 1 · length ≤ 5000 |
| audio | boolean | Whether to generate audio (dialogue and sound effects) with the video. When false, the output video is silent. | default: false |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| reference_image_urls | string[] | URLs or base64 data URIs of up to 12 reference images (png, jpeg, jpg, webp) used to keep subjects consistent. | |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| reference_audio_urls | string[] | URLs or base64 data URIs of up to 3 mp3 reference audio clips (3-12 seconds each, max 50 MB) used to keep voices consistent. | |
| resolution | enum | Output video resolution | 540p | 720p | 1080p | 2K | 4K · default: "720p" |
| duration | integer | Duration of the video in seconds (3-16) | 3 ≤ n ≤ 16 · default: 5 |
| aspect_ratio | enum | The aspect ratio of the output video | 16:9 | 9:16 | 4:3 | 3:4 | 1:1 · default: "16:9" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/vidu/q4/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}