GET
/v1/schemas/fal/video/bytedance/seedance-2.5/us/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracea631583aa474103cc548eeb687af368317c4dbf94d825a30c3de230bfde752d3{
"fetchedAt": 1793682002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
14 properties · 0 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| codec | enum | 'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. | auto | H264 | H265 · default: "auto" |
| 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" |
| task | enum | The type of video generation task. Reference uses the supplied media as guidance. Editing modifies a reference video and automatically coerces aspect_ratio and duration to auto. Extension continues a reference video and automatically coerces aspect_ratio to au… | auto | reference | editing | extension · default: "reference" |
| 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 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Di… | |
| 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 |
| draft | boolean | Generate a draft preview at 480p, overriding resolution. Returns a draft_id for completing the draft at 1080p within 7 days. | default: false |
| seed | integer | Random seed for reproducibility. Note that results may still vary slightly even with the same seed. | nullable |
| prompt | string | The text prompt used to generate the video. | 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 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. | |
| 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" |
| duration | enum | Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt. | auto | 4 | 5 | 6 | 7 | 8 · +22 more · default: "auto" |
| end_user_id | string | The unique user ID of the end user. | nullable |
| resolution | enum | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality. | 480p | 720p | 1080p · default: "720p" |
| image_urls | string[] | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.5/us/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}