GET
/v1/schemas/fal/video/bytedance/seedance-2.0/us/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace29095d02b003ef3561a16ee96ec42ff6fdc300607a6f38ab31cd6ba57e769f98{
"fetchedAt": 1792645225,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
11 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt used to generate the video. | |
| resolution | enum | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. | 480p | 720p | 1080p | 4k · default: "720p" |
| bitrate_mode | enum | Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. | standard | high · default: "standard" |
| aspect_ratio | enum | The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. | auto | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 · +1 more · default: "auto" |
| codec | enum | 'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. | auto | H264 | H265 · default: "auto" |
| image_urls | string[] | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. | items ≤ 9 |
| video_urls | string[] | Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640… | items ≤ 3 |
| generate_audio | boolean | Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. | default: true |
| end_user_id | string | The unique user ID of the end user. | nullable |
| audio_urls | string[] | Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file. At least one reference image or video is required. | items ≤ 3 |
| duration | enum | Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. | auto | 4 | 5 | 6 | 7 | 8 · +7 more · default: "auto" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.0/us/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}