Back to Image to video

Seedance 2.5 Image-to-Video

ByteDance

Generate video from an input image and text prompt with duration and resolution controls.

Current price
$0.0300/1k tokens
Availability
Ready to run
Last accepted verification

What this API does

Animate a public start image, optionally toward an end image, at 480p or 720p with native audio. The initial hold uses the widest supported frame because fal fixes image-to-video aspect ratio to auto; final settlement reads the generated MP4 dimensions and releases the difference.

Agents select this operation with tool ID bytedance.seedance-2-5-image-to-video, then inspect its current executable contract before a run.

Public input and output shape

Input

durationinteger · optional

Value supplied for duration.

minimum: 4 · maximum: 30

end_image_urlstring · optional

Value supplied for end image url.

format: uri

generate_audioboolean · optional

Value supplied for generate audio.

image_urlstring · required

Value supplied for image url.

format: uri

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 5000

resolutionstring · optional

Value supplied for resolution.

enum: 480p, 720p

Output

notestring

Returned note value.

videoobject

Returned video value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "bytedance.seedance-2-5-image-to-video",
  "input": {
    "prompt": "the burger remains centered while the camera makes a slow studio arc and soft light moves across the sesame bun",
    "duration": 4,
    "image_url": "https://storage.googleapis.com/falserverless/example_outputs/flux-2-flash-edit-input.png",
    "resolution": "480p",
    "generate_audio": true
  }
}

Output

{
  "note": "video returned as an artifact",
  "video": {
    "audio": true,
    "content_type": "video/mp4",
    "duration_seconds": 4
  }
}
Teaching errors and limitations
  • invalid_input: image_url must be a public JPEG, PNG or WebP URL and duration must be 4–30 secondsexample: {"prompt":"slowly rotate the product while soft daylight travels across the label","image_url":"https://storage.googleapis.com/falserverless/example_inputs/seedance_pro_i2v_img.jpg","resolution":"480p","duration":4,"generate_audio":true}
Updated
24 August 2026

Use Seedance 2.5 Image-to-Video with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.