# Seedance 2.5 Flash

ByteDance Seedance 2.5 Flash — быстрые клипы до 30 секунд со звуком, до 10 референсов в одном кадре

## Обзор

- **Modality:** Видео
- **Modes:** Текст → Видео, Картинка → Видео, Кадры → Видео, Референсы → Видео
- **Страница модели:** https://iskragen.ru/models/bytedance-seedance-2-5-flash
- **`modelSlug` для API:** `bytedance-seedance-2-5-flash`
- **Aspect ratios:** adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9

## Стоимость

- Базовая цена: 80–1200 ₽ за `video_4s`
- Цена с референс-видео — до 1493 ₽: секунды референс-видео входят в цену — она умножается на `(вход + выход) / выход` и на коэффициент модели 0.622. Референс-видео (`params.reference_video_urls`) — только файлы из `POST /v1/files`, суммарно до 30 секунд.

| Разрешение | Цена за 1 секунду | Примечание |
| --- | --- | --- |
| 480p | 20 ₽ | |
| 720p | 40 ₽ | по умолчанию |

Длительность от 4 до 30 секунд, цена растёт посекундно.

**Включено:**
- 480p и 720p
- До 10 референсов-картинок, 5 видео и 5 аудиодорожек
- Управление стартовым и финальным кадром

## Сценарии и параметры

### Текст → Видео

- Mode ID: `text-to-video`
- `modelSlug` для API: `bytedance-seedance-2-5-flash`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `resolution` | select | `720p` | `720p`, `480p` |  |
| `duration` | select | `5` | `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` | Длина видео от 4 до 30 секунд. Цена растёт посекундно. |
| `output_format` | select | `mp4` | `mp4`, `mov` | MP4 — универсальный, открывается везде. MOV — для монтажа в Final Cut и Premiere. |
| `return_last_frame` | toggle | false | true / false | Последний кадр видео придёт отдельной картинкой — удобно продолжать ролик следующей генерацией |
| `generate_audio` | toggle | true | true / false | Сгенерировать звуковую дорожку вместе с видео. |
| `web_search` | toggle | false | true / false | Разрешить модели искать в интернете контекст к промпту: реальные места, предметы, события |

### Картинка → Видео

- Mode ID: `image-to-video`
- `modelSlug` для API: `bytedance-seedance-2-5-flash`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `resolution` | select | `720p` | `720p`, `480p` |  |
| `duration` | select | `5` | `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` | Длина видео от 4 до 30 секунд. Цена растёт посекундно. |
| `output_format` | select | `mp4` | `mp4`, `mov` | MP4 — универсальный, открывается везде. MOV — для монтажа в Final Cut и Premiere. |
| `return_last_frame` | toggle | false | true / false | Последний кадр видео придёт отдельной картинкой — удобно продолжать ролик следующей генерацией |
| `generate_audio` | toggle | true | true / false | Сгенерировать звуковую дорожку вместе с видео. |
| `web_search` | toggle | false | true / false | Разрешить модели искать в интернете контекст к промпту: реальные места, предметы, события |
| `first_frame_url` | file | — | image, до 20 МБ |  |

### Кадры → Видео

- Mode ID: `frames-to-video`
- `modelSlug` для API: `bytedance-seedance-2-5-flash`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `resolution` | select | `720p` | `720p`, `480p` |  |
| `duration` | select | `5` | `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` | Длина видео от 4 до 30 секунд. Цена растёт посекундно. |
| `output_format` | select | `mp4` | `mp4`, `mov` | MP4 — универсальный, открывается везде. MOV — для монтажа в Final Cut и Premiere. |
| `return_last_frame` | toggle | false | true / false | Последний кадр видео придёт отдельной картинкой — удобно продолжать ролик следующей генерацией |
| `generate_audio` | toggle | true | true / false | Сгенерировать звуковую дорожку вместе с видео. |
| `web_search` | toggle | false | true / false | Разрешить модели искать в интернете контекст к промпту: реальные места, предметы, события |
| `first_frame_url` | file | — | image, до 20 МБ |  |
| `last_frame_url` | file | — | image, до 20 МБ | Кадр, к которому модель приведёт видео в финале |

### Референсы → Видео

- Mode ID: `reference-to-video`
- `modelSlug` для API: `bytedance-seedance-2-5-flash`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `resolution` | select | `720p` | `720p`, `480p` |  |
| `duration` | select | `5` | `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` | Длина видео от 4 до 30 секунд. Цена растёт посекундно. |
| `output_format` | select | `mp4` | `mp4`, `mov` | MP4 — универсальный, открывается везде. MOV — для монтажа в Final Cut и Premiere. |
| `return_last_frame` | toggle | false | true / false | Последний кадр видео придёт отдельной картинкой — удобно продолжать ролик следующей генерацией |
| `generate_audio` | toggle | true | true / false | Сгенерировать звуковую дорожку вместе с видео. |
| `web_search` | toggle | false | true / false | Разрешить модели искать в интернете контекст к промпту: реальные места, предметы, события |
| `reference_image_urls` | file-list | [] | image[], до 10 шт, 30 МБ | До 10 картинок: персонажи, объекты, стиль — модель перенесёт их в клип |
| `reference_video_urls` | file-list | [] | video[], до 5 шт, 200 МБ | До 5 роликов по 2–30 секунд, суммарно не больше 30 секунд: два ролика по 15 с подойдут, два по 20 с — уже нет. |
| `match_reference_duration` | toggle | false | true / false | Нужно ровно одно видео длительностью от 4 до 30 секунд. Ролик получит его длину и формат кадра. |
| `reference_audio_urls` | file-list | [] | audio[], до 5 шт, 15 МБ | До 5 дорожек по 2–30 секунд, суммарно не длиннее 30 секунд |

## Использование через API

Полный цикл интеграции: API-ключ → создание генерации → polling → результат. Базовый URL: `https://api.iskragen.ru/v1`.

### 1. Получите API-ключ

Личный кабинет → «API-ключи» (https://iskragen.ru/api-keys). Значение показывается один раз. Ключ передаётся в заголовке каждого запроса:

```
Authorization: Bearer iskr_live_<secret>
```

### 2. Создайте генерацию

```bash
curl -X POST https://api.iskragen.ru/v1/generations \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "modelSlug": "bytedance-seedance-2-5-flash",
  "prompt": "Опишите, что вы хотите сгенерировать",
  "params": {
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration": "5",
    "output_format": "mp4",
    "return_last_frame": false,
    "generate_audio": true,
    "web_search": false
  }
}'
```

Генерация асинхронная: ответ — `202 Accepted`, задача ставится в очередь, стоимость удерживается с баланса.

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "PENDING",
  "costRub": 160
}
```

### 3. Дождитесь результата (polling)

Опрашивайте `GET /v1/generations/{id}` раз в ~2 секунды, пока `status` не станет `SUCCEEDED` или `FAILED`:

```bash
curl https://api.iskragen.ru/v1/generations/$GENERATION_ID \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY"
```

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "SUCCEEDED",
  "outputUrls": ["https://s3.twcstorage.ru/.../result.webp"],
  "costRub": 160,
  "errorCode": null,
  "errorMessage": null
}
```

- `outputUrls` — ссылки на готовые файлы; заполняются при `SUCCEEDED`.
- При `FAILED` средства возвращаются на баланс автоматически, причина — в `errorCode` / `errorMessage`.
- Лимит: 5 одновременных генераций (`PENDING` + `PROCESSING`), при превышении — `429`.
- Для длинных задач (видео, музыка) вместо polling'а используйте [Webhooks](https://iskragen.ru/docs/webhooks.md).

### Полная документация

- Generations API (все поля, image-to-image, ошибки): https://iskragen.ru/docs/api-generations.md
- Аутентификация: https://iskragen.ru/docs/authentication.md
- Ошибки: https://iskragen.ru/docs/errors.md
- Лимиты: https://iskragen.ru/docs/rate-limits.md
- Индекс всей документации для LLM: https://iskragen.ru/llms.txt
- Машиночитаемый каталог моделей (slug, params, цены): https://api.iskragen.ru/v1/catalog
