GET
/v1/schemas/fal/video/bytedance/seedance-2.5/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace623e4fe87a6c2288ce126e12639ce0d2e958bb50ac8ea9a95afd53b3816ac115{
"fetchedAt": 1790658077,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
14 properties · 0 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt | string | The text prompt used to generate the video. | nullable |
| draft | boolean | Generate a draft preview at 480p, overriding resolution. Returns a draft_id for completing the draft at 1080p within seven days. | default: false |
| codec | enum | 'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. | auto | H264 | H265 · default: "auto" |
| 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" |
| end_user_id | string | The unique user ID of the end user. | nullable |
| 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" |
| 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" |
| 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 |
| 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… | reference | editing | extension · default: "reference" |
| 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. | |
| 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. | |
| 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… | |
| resolution | enum | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality. | 480p | 720p | 1080p · default: "720p" |
| seed | integer | Random seed for reproducibility. Note that results may still vary slightly even with the same seed. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.5/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}