---
title: "Seedance 2.5 API: slug, параметры и доступность"
description: "Как проверить доступность Seedance 2.5, выбрать T2V/I2V slug, получить схему и отправить генерацию."
---

Seedance 2.5 поддерживает два публичных режима API:

| Режим | API slug |
| --- | --- |
| Text-to-video | `seedance-2-5-t2v` |
| Image-to-video | `seedance-2-5-i2v` |

<Callout type="info" title="Проверяйте доступность в своём окружении">
Активация модели управляется отдельно от деплоя кода. Slug можно использовать
только если он возвращается в `GET /v1/models` для вашего API-ключа. Если slug
ещё не виден, генерация вернёт `model_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(({ slug }) => 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 = client.models.list()
seedance_25 = [
    model for model in catalog["data"]
    if model["slug"].startswith("seedance-2-5")
]

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

</Tab>
</Tabs>

## Подтверждённые ограничения

| Параметр | Значения |
| --- | --- |
| Prompt | до `30000` символов |
| Duration | 4–30 секунд |
| Resolution | `480p`, `720p` |
| Aspect ratio | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `adaptive` |
| Reference images | до 30 |
| Reference videos | до 10 |
| Reference audio | до 10 |
| Native audio | `generate_audio: true` |

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

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

```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`. Цена зависит от длительности,
разрешения и генерации аудио.

## Отправить 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": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'
```

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

## Явный fallback

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