Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive · По умолчанию: adaptive |
duration_seconds | Нет | Длина ролика. Оплата посекундная. 4–30 · По умолчанию: 5 |
enable_web_search | Нет | Сначала проверяет в интернете даты, места и свежие факты. По умолчанию: false |
generate_audio | Нет | Добавляет звук под картинку: голоса, атмосферу и эффекты. По умолчанию: true |
output_format | Нет | Формат файла результата. mp4 · mov · По умолчанию: mp4 |
prompt | Да | What to generate: subject, action, camera movement and mood. |
reference_audio_urls | Нет | Звук-образец: голос, музыка или ритм. |
reference_image_urls | Нет | Изображения людей, одежды или мест, которые нужно сохранить. |
reference_video_urls | Нет | Ролики, движение, камеру или стиль которых нужно повторить. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 480p · 720p · 1080p · По умолчанию: 720p |
return_last_frame | Нет | Also return the clip’s final frame as a separate image. По умолчанию: false |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
watermark | Нет | Ask the model to watermark the video as AI-generated. По умолчанию: false |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| resolution 480p · with_video true | 11,07 | 0,11 $ |
| resolution 480p · with_video false | 18,51 | 0,19 $ |
| resolution 720p · with_video true | 24,89 | 0,25 $ |
| resolution 720p · with_video false | 41,6 | 0,42 $ |
| resolution 1080p · with_video true | 61,23 | 0,61 $ |
| resolution 1080p · with_video false | 102,35 | 1,02 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 56 кредитов за клип длиной 5 с (0,56 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Seedance 2.5 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seedance-2.5/reference-to-video и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"aspect_ratio": "adaptive",
"resolution": "720p",
"duration_seconds": 5,
"generate_audio": true
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Seedance 2.5
Сколько стоит API Seedance 2.5?
Seedance 2.5 стоит от 56 кредитов (0,56 $) за клип длиной 5 с — на самой дешёвой задаче «Видео по референсам». Цены по вариантам: 480p · true 11,07 кредита за секунду, 480p · false 18,51 кредита за секунду, 720p · true 24,89 кредита за секунду, 720p · false 41,6 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Seedance 2.5 в API?
Укажите bytedance/seedance-2.5/text-to-video — Создать видео; bytedance/seedance-2.5/image-to-video — Видео из картинки; bytedance/seedance-2.5/reference-to-video — Видео по референсам; bytedance/seedance-2.5/video-extend — Продлить видео в поле model запроса POST /jobs/createTask.
Seedance 2.5 генерирует звук?
Да, в том же проходе, что и картинку. generate_audio по умолчанию true и даёт атмосферу, эффекты движения и голос, привязанные к кадрам. Для немых петель и для всего, что озвучат на постпродакшене, звук лучше выключить.
Какие разрешения поддерживает API Seedance 2.5?
480p, 720p и 1080p, по умолчанию 720p. Разрешение выбирает тарифную ступень и определяет итоговый файл. Детали, которой не было в первом кадре или в референсах, оно не добавит. Черновики гоняйте в 480p, а удачный дубль перезапустите в том размере, в котором отдаёте.
Можно задать и первый, и последний кадр?
Да, в image-to-video. last_image_url принимается только вместе с image_url, отдельно — никогда. Отправьте оба, и у кадра появится заданная точка прибытия: именно это делает переходы, раскрытия и петли воспроизводимыми. Если два кадра сильно расходятся по крупности или свету, середина становится непредсказуемой.
Какие ограничения у API Seedance 2.5?
Длина клипа: 4–30 s; Разрешения: 480p · 720p · 1080p; Соотношения сторон: 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive; Референсное аудио: 10; Референсные изображения: 30. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Seedance 2.5 без кода?
Да. Playground запускает Seedance 2.5 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Seedance
Seedance 2.0 доходит до 4K, но ограничен 15 секундами, зато стоит дешевле за секунду. Seedance 2.5 даёт до 30 секунд за один дубль и принимает самые большие наборы референсов.
- Seedance 2.5 APIНовинка ByteDance: клипы по 30 секунд со встроенным звукомОт 56 кредитов за клип длиной 5 с
- Seedance 2.0 Mini APIЛёгкий Seedance для быстрых черновиков 720p со звукомОт 9 кредитов за клип длиной 5 с
- Seedance 2.0 APIКинематографичные клипы до 4K со встроенным звукомОт 33 кредитов за клип длиной 5 с
- Seedance 2.0 Fast APIУскоренный Seedance 2.0 со звуком в 720pОт 17 кредитов за клип длиной 5 с
- Seedance 1.5 Pro APIКлипы со встроенным звуком и неподвижной камерой по желаниюОт 9 кредитов за клип длиной 5 с

