Seedance 2.5

Model id seedance-2.5 · ByteDance · video · 5 modes: text-to-video, image-to-video, reference-to-video, extend, edit.

This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls get_model with the mode.

Text To Video

Mode text-to-video. Text to video.

Input

Field	Type	Required	Allowed	Default	Description
`prompt`	string	Yes	up to 15,000 characters		What the video should show: subject, action, camera and style.
`duration`	number or integer		`-1`, or 4 to 30		Video duration in seconds. Integer 4-30, or -1 to let the model pick the length (billed on the length it picks); defaults to 5 when omitted.
`resolution`	string		`480p`, `720p`, `1080p`	`720p`	Video resolution.
`aspect_ratio`	string		`16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`		Aspect ratio. Defaults to 16:9.

Pricing

~11.18 credits per second at 720p (Seedance 2.5; rate varies by resolution; output + input-video seconds both billed). Settled on actual usage: the reserve is adjusted to what the model produced, and the difference refunded. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "seedance-2.5",
  "mode": "text-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}

Image To Video

Mode image-to-video. Animate a first frame, or go from a first to a last frame.

Input

Field	Type	Required	Allowed	Default	Description
`prompt`	string	Yes	up to 15,000 characters		What the video should show: subject, action, camera and style.
`duration`	number or integer		`-1`, or 4 to 30		Video duration in seconds. Integer 4-30, or -1 to let the model pick the length (billed on the length it picks); defaults to 5 when omitted.
`resolution`	string		`480p`, `720p`, `1080p`	`720p`	Video resolution.
`first_frame`	File				The image to use as the first frame of the video.
`last_frame`	File				The image to use as the last frame. With a first frame, the video goes from one to the other.

Pricing

Example

The arguments of generate_media:

{
  "model": "seedance-2.5",
  "mode": "image-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "resolution": "720p"
  }
}

Reference To Video

Mode reference-to-video. A video guided by references: up to 30 images, 10 videos and 10 audios.

Input

Field	Type	Required	Allowed	Default	Description
`prompt`	string	Yes	up to 15,000 characters		What the video should show: subject, action, camera and style.
`duration`	number or integer		`-1`, or 4 to 30		Video duration in seconds. Integer 4-30, or -1 to let the model pick the length (billed on the length it picks); defaults to 5 when omitted.
`resolution`	string		`480p`, `720p`, `1080p`	`720p`	Video resolution.
`aspect_ratio`	string		`16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`		Aspect ratio. Defaults to 16:9.
`references`	File list		0 to 50 items		References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`.

References: up to 50: 30 images, 10 videos of 1.8 to 30.2 s (30 s in total), 10 audio files (30 s in total). Assets, URLs and elements are accepted.

Pricing

Example

The arguments of generate_media:

{
  "model": "seedance-2.5",
  "mode": "reference-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera, keeping the look of the reference",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}

Extend

Mode extend. Extend an input video forward or backward; the output keeps its ratio.

Input

Field	Type	Required	Allowed	Default	Description
`prompt`	string	Yes	up to 15,000 characters		What the video should show: subject, action, camera and style.
`resolution`	string		`480p`, `720p`, `1080p`	`720p`	Video resolution.
`duration`	integer		4 to 30		Length of the added video in seconds, 4-30; defaults to 5.
`references`	File list	Yes	1 to 50 items		References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`.

References: up to 50: 30 images, 10 videos of 1.8 to 30.2 s (30 s in total), 10 audio files (30 s in total). Assets, URLs and elements are accepted.

Pricing

Example

The arguments of generate_media:

{
  "model": "seedance-2.5",
  "mode": "extend",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera, keeping the look of the reference",
    "resolution": "720p",
    "duration": 4,
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}

Edit

Mode edit. Edit the visuals or audio of an input video; the output keeps its ratio and length.

Input

Field	Type	Required	Allowed	Default	Description
`prompt`	string	Yes	up to 15,000 characters		What the video should show: subject, action, camera and style.
`resolution`	string		`480p`, `720p`, `1080p`	`720p`	Video resolution.
`references`	File list	Yes	1 to 50 items		References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`.

References: up to 50: 30 images, 10 videos of 1.8 to 30.2 s (30 s in total), 10 audio files (30 s in total). Assets, URLs and elements are accepted.

Pricing

Example

The arguments of generate_media:

{
  "model": "seedance-2.5",
  "mode": "edit",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera, keeping the look of the reference",
    "resolution": "720p",
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}

Models

Video

Image

Audio

Seedance 2.5

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example

Reference To Video

Input

Pricing

Example

Extend

Input

Pricing

Example

Edit

Input

Pricing

Example

​Text To Video

​Input

​Pricing

​Example

​Image To Video

​Input

​Pricing

​Example

​Reference To Video

​Input

​Pricing

​Example

​Extend

​Input

​Pricing

​Example

​Edit

​Input

​Pricing

​Example

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example

Reference To Video

Input

Pricing

Example

Extend

Input

Pricing

Example

Edit

Input

Pricing

Example