GET

/v1/schemas/fal/video/bytedance/seedance-2.0/us/image-to-video

kind inputactivity videohash fbd9a7ba…extracted Nov 20, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
e0b4b2b8a29bc5241dd0068ed7a595afd0558b8bf1b0bd99ca014c8840802b59
{
  "fetchedAt": 1795150801,
  "extractorVersion": "2",
  "verifiedAt": null
}

Request body

10 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.
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
resolutionenumVideo resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality.480p | 720p | 1080p | 4k · default: "720p"
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"
bitrate_modeenumOutput 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 tokens
shell
$ 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", …}]}