GET

/v1/schemas/fal/video/bytedance%2Fseedance-2.0%2Fmini%2Fimage-to-video

kind inputactivity videohash a0c14557…extracted Nov 20, 2026version currentsource upstream spec ↗

Request body

9 properties · 2 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.
prompt*stringThe text prompt describing the desired motion and action for the video.
resolutionenumVideo resolution - 480p for faster generation, 720p for balance.480p | 720p · 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_ratioenumThe 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"
end_user_idstringThe unique user ID of the end user.nullable
durationenumDuration 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"
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"

Validate a payload

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