GET
/v1/schemas/fal/video/bytedance%2Fseedance-2.0%2Ffast%2Freference-to-video
Accept:
Request body
10 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt used to generate the video. | |
| end_user_id | string | The unique user ID of the end user. | nullable |
| 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" |
| 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" |
| 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 |
| 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… | |
| resolution | enum | Video resolution - 480p for faster generation, 720p for balance. | 480p | 720p · default: "720p" |
| image_urls | string[] | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. | |
| 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.If audio is provided, at least one reference image or … | |
| 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" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.0/fast/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}