GET

/v1/schemas/fal/video/bytedance%2Fseedance-2.5%2Fus%2Fimage-to-video

kind inputactivity videohash a65f8131…extracted Nov 21, 2026version currentsource upstream spec ↗

Request body

12 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
image_url*stringThe URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB.
output_formatenumOutput 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"
durationenumDuration 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"
bitrate_modeenumOutput bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.standard | high · default: "standard"
resolutionenumVideo resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality.480p | 720p | 1080p | 4k · default: "720p"
end_image_urlstringThe 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
aspect_ratioconstThe aspect ratio of the generated video. Always "auto" for image-to-video"auto" · default: "auto"
generate_audiobooleanWhether 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
codecenum'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"
draftbooleanGenerate a draft preview at 480p, overriding resolution. Returns a draft_id for completing the draft at 1080p or 4k within 14 days.default: false
promptstringThe text prompt describing the desired motion and action for the video.nullable
end_user_idstringThe unique user ID of the end user.nullable

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"bytedance/seedance-2.5/us/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}