Справочник API
Seedance 2.5 API: параметры и цены
Seedance 2.5 в API Clipia — slug для T2V и I2V, ограничения параметров, проверка доступности в каталоге, оценка цены и отправка генерации через REST.
Seedance 2.5 — видеомодель ByteDance. В API у неё два публичных режима: генерация видео по тексту и по изображению.
| Режим | Slug для API |
|---|---|
| Text-to-video | seedance-2-5-t2v |
| Image-to-video | seedance-2-5-i2v |
Проверяйте доступность в своём окружении
Модель включается отдельно от выпуска кода; в боевом каталоге оба slug есть (снимок от 4 ноября 2026 года). Используйте slug, только если он есть в ответе GET /v1/models для вашего API-ключа: выключенная модель исчезает из списка, а отправка генерации возвращает 404 с кодом not_found.
Чтобы сгенерировать видео без API, откройте лендинг Seedance 2.5: он появляется в каталоге Clipia, только когда активны оба режима.
Проверить доступность
curl -s https://api.clipia.ai/v1/models \
-H "Authorization: Bearer $CLIPIA_KEY" \
| jq '.data[] | select((.slug // "") | startswith("seedance-2-5"))'LLM-модели в том же списке не имеют slug, поэтому примеры проверяют его наличие — см. «Каталог моделей».
Ограничения параметров
Снимок 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 |
Умолчания — это умолчания исполнения: запрос без параметра оценивается и исполняется именно с ними.
Получить схему и цену
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 — см. «Оценка стоимости». Цена зависит от длительности и разрешения; звук на цену не влияет.
Цены
Цены актуальны на ноябрь 2026 года. Точная стоимость всегда видна на кнопке запуска до списания.
Отправить text-to-video
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.
Каталог моделей
GET /v1/models — список моделей Clipia для изображений, видео и аудио с точными slug, схемой параметров и ценой, включая slug с косой чертой.
Оценка стоимости
POST /v1/models/{model}/estimate — узнать стоимость генерации в кредитах до запуска; задача не создаётся, кредиты не резервируются и не списываются.