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

# Seedance 2.5

> ByteDance Seedance 2.5 generates coherent continuous videos or multi-shot sequences with native audio, strong prompt and layout adherence, first/last-frame control, and up to 50 multimodal references.

ByteDance Seedance 2.5 generates coherent continuous videos or multi-shot sequences with native audio, strong prompt and layout adherence, first/last-frame control, and up to 50 multimodal references.

| | |
| - | - |
| Model id | `seedance-2-5-fal` |
| Media | video |
| Submit to | `POST /v1/videos` |
| Price | varies by tier and settings; `GET /v1/models/seedance-2-5-fal/estimate` quotes it |
| Typical time | about 420.0 s |

## Text → Video

Generate one continuous take or a prompted multi-shot sequence with synchronized audio in a single pass.

Select it with `"mode": "text_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `duration_seconds`\
**Optional:** `aspect_ratio`, `generate_audio`

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "seedance-2-5-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "text_to_video",
  "aspect_ratio": "auto",
  "duration_seconds": 5,
  "generate_audio": true,
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `"auto"` |
| `duration_seconds` | 4.0 – 30.0 seconds | `5` |
| `generate_audio` | `true`, `false` | `true` |

## Image → Video

Animate a required opening image, with an optional closing image. Output framing follows the input images.

Select it with `"mode": "image_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `first_frame`, `duration_seconds`\
**Optional:** `last_frame`, `generate_audio`

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "seedance-2-5-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "image_to_video",
  "duration_seconds": 5,
  "generate_audio": true,
  "first_frame": "asset_…",
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `duration_seconds` | 4.0 – 30.0 seconds | `5` |
| `generate_audio` | `true`, `false` | `true` |
| `first_frame` | asset id (up to 1) | |
| `last_frame` | asset id (up to 1) | |

## Reference → Video

Guide characters, environments, style, motion, and sound with up to 30 images, 10 videos, and 10 audio clips (50 files total). Reference video and audio duration totals are each capped at 30.2 seconds.

Select it with `"mode": "reference_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `duration_seconds`\
**Optional:** `reference_images`, `reference_videos`, `reference_audios`, `aspect_ratio`, `generate_audio`

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "seedance-2-5-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "reference_to_video",
  "aspect_ratio": "auto",
  "duration_seconds": 5,
  "generate_audio": true,
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `"auto"` |
| `duration_seconds` | 4.0 – 30.0 seconds | `5` |
| `generate_audio` | `true`, `false` | `true` |
| `reference_images` | asset ids (up to 30) | |
| `reference_videos` | asset ids (up to 10) | |
| `reference_audios` | asset ids (up to 10) | |

## Edit video

Change the clip you attach: add, remove or replace something, or restyle it. The result keeps the clip's length and framing, and is billed on the clip's length.

Select it with `"mode": "video_edit"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `source_video`\
**Optional:** `reference_images`, `reference_audios`, `generate_audio`

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "seedance-2-5-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "video_edit",
  "generate_audio": true,
  "source_video": "asset_…",
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `generate_audio` | `true`, `false` | `true` |
| `source_video` | asset id (up to 1) | |
| `reference_images` | asset ids (up to 30) | |
| `reference_audios` | asset ids (up to 10) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/seedance-2-5-fal` is always current.


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