scrollport
Back to Reference to video

Seedance 2.5 Reference-to-Video

ByteDance

Generate video from referenced images, optional audio and a tagged text prompt with duration and resolution controls.

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

What this API does

Create a 480p or 720p Seedance 2.5 clip from one or more public reference images and optional audio references. Scrollport exposes explicit aspect ratio and duration so the pre-run hold and final token settlement remain exact; video-reference inputs stay excluded until their duration-sensitive supplier cost can be bounded safely.

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

Public input and output shape

Input

aspect_ratiostring · optional

Value supplied for aspect ratio.

enum: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

audio_urlsarray · optional

Value supplied for audio urls.

maxItems: 10

durationinteger · optional

Value supplied for duration.

minimum: 4 · maximum: 30

generate_audioboolean · optional

Value supplied for generate audio.

image_urlsarray · required

Value supplied for image urls.

minItems: 1 · maxItems: 30

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-reference-to-video",
  "input": {
    "prompt": "@Image1 remains the hero product while the camera arcs slowly and soft studio light moves across the sesame bun",
    "duration": 4,
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_outputs/flux-2-flash-edit-input.png"
    ],
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "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_urls must contain 1–30 public image URLs and duration must be 4–30 secondsexample: {"prompt":"@Image1 remains the hero product while the camera arcs slowly through soft studio light","image_urls":["https://storage.googleapis.com/falserverless/example_inputs/seedance_pro_i2v_img.jpg"],"aspect_ratio":"16:9","resolution":"480p","duration":4,"generate_audio":true}
Updated
24 August 2026

Use Seedance 2.5 Reference-to-Video with Scrollport

Use 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.