---
title: "Seedance 2.5 API: параметры и цены"
description: Seedance 2.5 в API Clipia — slug для T2V и I2V, ограничения параметров, проверка доступности в каталоге, оценка цены и отправка генерации через REST.
icon: Clapperboard
---

Seedance 2.5 — видеомодель ByteDance. В API у неё два публичных режима: генерация видео по тексту и по изображению.

| Режим | Slug для API |
| --- | --- |
| Text-to-video | `seedance-2-5-t2v` |
| Image-to-video | `seedance-2-5-i2v` |

<Callout type="info" title="Проверяйте доступность в своём окружении">
Модель включается отдельно от выпуска кода; в боевом каталоге оба slug есть (снимок от 4 ноября 2026 года). Используйте slug, только если он есть в ответе `GET /v1/models` для вашего API-ключа: выключенная модель исчезает из списка, а отправка генерации возвращает `404` с кодом `not_found`.
</Callout>

Чтобы сгенерировать видео без API, откройте [лендинг Seedance 2.5](/ru/video-models/seedance-2-5): он появляется в каталоге Clipia, только когда активны оба режима.

## Проверить доступность

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl -s https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  | jq '.data[] | select((.slug // "") | startswith("seedance-2-5"))'
```

</Tab>
<Tab value="TypeScript">

```ts
const { data } = await clipia.models.list();
const seedance25 = data.filter(
  (model) => "slug" in model && model.slug?.startsWith("seedance-2-5"),
);

if (seedance25.length === 0) {
  throw new Error("Seedance 2.5 is not active in this environment");
}
```

</Tab>
<Tab value="Python">

```python
catalog = clipia.models.list()
seedance_25 = [
    model for model in catalog["data"]
    if (model.get("slug") or "").startswith("seedance-2-5")
]

if not seedance_25:
    raise RuntimeError("Seedance 2.5 is not active in this environment")
```

</Tab>
</Tabs>

LLM-модели в том же списке не имеют `slug`, поэтому примеры проверяют его наличие — см. [«Каталог моделей»](/ru/docs/api-reference/models).

## Ограничения параметров

Снимок `input_schema` на 4 ноября 2026 года. Точный набор полей для выбранного режима возвращает `GET /v1/models/{slug}` — он важнее статического списка на этой странице.

| Параметр | Значения |
| --- | --- |
| `prompt` | до 20 480 символов. Модель заявляет `30000`, но более длинный промпт не исполняет, поэтому API принимает 20 480 |
| `image_url` | только `seedance-2-5-i2v`, обязателен: исходное изображение по HTTPS-ссылке |
| `duration` | `4`, `5`, `6`, `8`, `10`, `12`, `15`, `20`, `25` или `30` секунд; по умолчанию `4` |
| `resolution` | `480p`, `720p`, `1080p`; по умолчанию `720p` |
| `aspect_ratio` | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `adaptive`; по умолчанию `16:9` для T2V и `adaptive` для I2V |
| `reference_video_urls` | до 10 ссылок; запрос с большим числом роликов отклоняется кодом `400` до резерва кредитов |
| `reference_image_urls`, `reference_audio_urls` | референсы модели: до 30 изображений и до 10 аудио. Схема их не объявляет; запрос сверх лимита не отклоняется, лишние ссылки молча отбрасываются |
| `generate_audio` | звук включён по умолчанию; `generate_audio: false` — ролик без звука. Если звуковая дорожка не прошла проверку безопасности, ролик приходит без звука с предупреждением `audio_dropped` |

Умолчания — это умолчания исполнения: запрос без параметра оценивается и исполняется именно с ними.

## Получить схему и цену

```bash
curl https://api.clipia.ai/v1/models/seedance-2-5-t2v \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

Перед запуском передайте тот же `input` в `POST /v1/models/seedance-2-5-t2v/estimate` — см. [«Оценка стоимости»](/ru/docs/api-reference/estimate). Цена зависит от длительности и разрешения; звук на цену не влияет.

<Callout type="info" title="Цены">
Цены актуальны на ноябрь 2026 года. Точная стоимость всегда видна на кнопке запуска до списания.
</Callout>

## Отправить text-to-video

```bash
curl -X POST https://api.clipia.ai/v1/models/seedance-2-5-t2v \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "One continuous cinematic tracking shot through a storm",
      "duration": 10,
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'
```

Для image-to-video используйте `seedance-2-5-i2v` и передайте изображение в поле `image_url`, как объявлено в его `input_schema`. Не переносите имена полей из других интеграций.

## Явная замена модели

Если Seedance 2.5 нет в живом каталоге, можно явно выбрать `seedance-2-fast-t2v` или `seedance-2-fast-i2v`. Не подменяйте модель молча, если пользователь выбрал именно версию 2.5.