GET
/v1/schemas/fal/video/bytedance/seedance-2.5/flash/reference-to-video
Accept:
Request body
14 properties · 0 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| resolution | enum | Video resolution - 480p for faster generation, 720p for quality. | 480p | 720p · default: "720p" |
| end_user_id | string | The unique user ID of the end user. | nullable |
| 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 5 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. An … | |
| 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" |
| 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 10 images. | |
| seed | integer | Random seed for reproducibility. Note that results may still vary slightly even with the same seed. | nullable |
| output_format | enum | Output video format. 'mp4' is broadly compatible with browsers, mobile devices and media players. 'mov' targets professional post-production such as color grading, keying and compositing, but may not be supported by all players. | mp4 | mov · default: "mp4" |
| 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" |
| prompt | string | The text prompt used to generate the video. | nullable |
| 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 |
| 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 5 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. | |
| 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" |
| 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" |
| codec | enum | 'auto' uses the default video codec; US backend output is kept unchanged. 'H264' and 'H265' select H.264 and H.265 respectively. | auto | H264 | H265 · default: "auto" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.5/flash/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}