GET
/v1/schemas/fal/video/bytedance/seedance-2.0/us/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace19476c9e0051236c4842e35c28f0d88b1f53346882790e359f9984d68711daa4{
"fetchedAt": 1792645225,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt describing the desired motion and action for the video. | |
| image_url* | string | The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB. | |
| end_image_url | string | The URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB. | 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" |
| 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" |
| 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 infer from the input image. | 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 |
| 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" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bytedance/seedance-2.0/us/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}