> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.5

> Generate a video with Seedance 2.5 from text, from a first and/or last frame, or guided by references (up to 30 images, 10 videos, 10 audios); or extend or edit an input video. Up to 30 s, 480p/720p/1080p.

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

> [!NOTE]
>
> 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`](https://docs.argil.ai/v2/mcp/tools) 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`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "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](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | | | | The image to use as the first frame of the video. |
| `last_frame` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | | | | The image to use as the last frame. With a first frame, the video goes from one to the other. |

### 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`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "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](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) 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

\~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`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "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](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) 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

\~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`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "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](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) 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

\~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`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "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"
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.