Seedance 2.5 Reference-to-Video

ByteDance

Generate video with duration, resolution and native audio controls.

Capability: Video generation
Current price: $0.0150/1k tokens
Availability: Ready to run

What this API does

Create a 4–30 second Seedance 2.5 video at 480p or 720p using the prompt and references shown in the input schema. Native audio is included. Reserve the maximum output-token charge, then pay only for the generated output tokens after the video has been preserved as a Scrollport artifact. Failed requests are uncharged. The same job resumes after interruption. The model rejects reference images containing real human faces. Video references are excluded.

Agents select this operation with tool ID bytedance.seedance-2-5-reference, then check its current inputs and price before a run.

Inputs and outputs

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

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "bytedance.seedance-2-5-reference",
  "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
  }
}

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 and soft studio light moves across the sesame bun","image_urls":["https://storage.googleapis.com/falserverless/example_outputs/flux-2-flash-edit-input.png"],"aspect_ratio":"16:9","resolution":"480p","duration":4,"generate_audio":true}

Use Seedance 2.5 Reference-to-Video with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.