Да, официальный API есть: Seedance 2.5 и модели семейства 2.0 вызываются через Ark API на двух облачных платформах ByteDance — BytePlus ModelArk (международная консоль) и Volcengine Ark (火山方舟, аккаунты материкового Китая). Запрос везде один: POST {base}/contents/generations/tasks с заголовком Authorization: Bearer $ARK_API_KEY, затем вы опрашиваете задачу по ID до статуса succeeded и сразу скачиваете ролик по content.video_url. Различаются базовый URL, префикс ID модели (dreamina- на BytePlus, doubao- на Volcengine) и порог подключения: от $30 на BytePlus и от 200 юаней на Volcengine. Для разработчиков из России есть существенная оговорка: России нет в списке стран, где BytePlus предоставляет доступ к моделям, поэтому на практике остаётся посредник с тем же форматом запроса. Все ID, лимиты и коды ниже приведены по документации BytePlus и Volcengine по состоянию на 15 ноября 2026 года.
Пять фактов о Seedance API перед первым вызовом
- Эндпоинт. BytePlus:
https://ark.ap-southeast.bytepluses.com/api/v3, Volcengine:https://ark.cn-beijing.volces.com/api/v3. Задача создаётся на/contents/generations/tasks. Формат не совместим с OpenAI: тело запроса — этоmodel, массивcontent[]и параметры верхнего уровня. - Модель. Основная модель —
dreamina-seedance-2-5-260628на BytePlus иdoubao-seedance-2-5-260628на Volcengine. Seedance 2.5 Flash открывается для вызовов API 15 ноября 2026 года в 14:00 по UTC+8, а Seedance 1.5 Pro на BytePlus отключена 11 ноября без автоматического переноса. - Доступ. Модель нужно активировать: на BytePlus — от $30 кредитов, AI Savings Plan или пакетов ресурсов, на Volcengine — от 200 юаней и верификация по реальному имени (实名认证).
- Лимиты. Личный аккаунт — 180 запросов в минуту и 3 одновременные задачи на модель, корпоративный — 600 и 10. Задачи сверх лимита параллельности встают в очередь, а превышение RPM возвращает 429.
- Деньги. Оплата идёт по токенам, фактическое списание видно в
usage.completion_tokens. Ролик 10 секунд 720p 16:9 на Seedance 2.5 по прайсу BytePlus на 14 ноября 2026 года стоит около $2,31. Списывают только успешно сгенерированные видео.
Что такое Seedance 2.0 API и доступен ли он?
Да, доступен. ByteDance анонсировала Seedance 2.0 в феврале 2026 года, и сейчас модели 2.0, 2.0 Fast, 2.0 Mini и более новая Seedance 2.5 работают через официальный Ark API на BytePlus ModelArk и Volcengine Ark. Это асинхронный API задач: вы отправляете промпт и, при необходимости, изображения, видео или аудио, получаете ID задачи, а готовый ролик со звуком забираете по ссылке после завершения.
Что умеют модели через API на 15 ноября 2026 года:
- Seedance 2.5 — ролики от 4 до 30 секунд, разрешение до 1080p, до 30 референсных изображений, 10 видео и 10 аудио в одном запросе, режим черновика (draft) и редактирование или продление видео.
- Seedance 2.0 — от 4 до 15 секунд, разрешение до 4k, до 9 изображений, 3 видео и 3 аудио.
- 2.0 Fast и 2.0 Mini — то же семейство 2.0, но только 480p и 720p и дешевле.
Звук по умолчанию включён и выходит в стерео. Подробнее о выборе между версиями — в материале Модели Seedance в 2026 году: как выбрать 2.5, 2.0, Fast или Mini.
Помимо официальных консолей, Seedance продают и сторонние площадки — fal, Replicate, OpenRouter, Together, российские шлюзы. У каждой свой API и свои ID вроде bytedance/seedance-2.0, а не эндпоинт Ark. Код из этого руководства работает с официальным форматом Ark и с посредниками, которые повторяют его один в один.
Какие ID моделей Seedance работают на 15 ноября 2026 года
| Модель | ID на BytePlus ModelArk | ID на Volcengine Ark | Состояние |
|---|---|---|---|
| Seedance 2.5 | dreamina-seedance-2-5-260628 | doubao-seedance-2-5-260628 | работает |
| Seedance 2.5 Flash | dreamina-seedance-2-5-flash-261115 | версия ID не опубликована, в прайсе — doubao-seedance-2.5-flash | вызовы API с 15 ноября 2026 года, 14:00 по UTC+8; в прайсе только 480p и 720p, параметры и лимиты пока не описаны |
| Seedance 2.0 | dreamina-seedance-2-0-260128 | doubao-seedance-2-0-260128 | работает, единственная модель с 4k |
| Seedance 2.0 Fast | dreamina-seedance-2-0-fast-260128 | doubao-seedance-2-0-fast-260128 | работает, 480p и 720p |
| Seedance 2.0 Mini | dreamina-seedance-2-0-mini-260615 | doubao-seedance-2-0-mini-260615 | работает, 480p и 720p |
| Seedance 1.0 Pro и Pro Fast | seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015 | doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015 | ещё в списке; на Volcengine помечены как скоро отключаемые |
| Seedance 1.5 Pro | seedance-1-5-pro-251215 | — | на BytePlus отключена после 17:00 по UTC+8 11 ноября 2026 года без переноса; рекомендованная замена — dreamina-seedance-2-0-mini-260615 |
Источники: список моделей BytePlus, уведомление об отключении моделей, список моделей Volcengine. Учтите, что первый пример на странице создания задачи BytePlus до сих пор использует seedance-1-5-pro-251215: если скопировать его без правки, запрос пойдёт к уже отключённой модели.
BytePlus ModelArk или Volcengine Ark: чем отличаются консоли
API у обеих платформ одинаковый, а условия разные:
| BytePlus ModelArk | Volcengine Ark | |
|---|---|---|
| Для кого | международные аккаунты из стран, перечисленных в списке доступности | аккаунты материкового Китая |
| Базовый URL | https://ark.ap-southeast.bytepluses.com/api/v3 | https://ark.cn-beijing.volces.com/api/v3 |
| Префикс ID модели | dreamina-seedance-… | doubao-seedance-… |
| Авторизация | только API-ключ | API-ключ или подпись AK/SK; при AK/SK в model указывается Endpoint ID |
| Порог подключения Seedance 2.x | любой из вариантов: кредиты от $30, AI Savings Plan от $30, пакеты ресурсов от $30 | любой из вариантов: баланс от 200 юаней, план экономии от 200 юаней, пакет ресурсов от 200 юаней |
| Верификация | для активации корпоративная верификация не требуется | для платного использования нужна верификация по реальному имени (实名认证) |
| Бесплатная квота | квота бесплатного инференса на каждую модель, размер для Seedance не указан | показывается только в консоли |
| Лимиты 2.5 и 2.0 | 180 RPM / 3 задачи (личный), 600 RPM / 10 задач (корпоративный) | те же цифры, но с оговоркой, что онлайн-лимиты не гарантируются |
| Только здесь | код InflightBatchsizeExceeded | параметр tools с веб-поиском, код ModelAccountConcurrentRequestsLimitExceeded |
Условия подключения: активация Seedance на BytePlus, активация на Volcengine.
Эндпоинты и параметры Seedance 2.0 API

Отдельных эндпоинтов для текста, изображений и статуса нет: весь Seedance API — это четыре операции над одним ресурсом задач. Пути одинаковы на BytePlus и Volcengine, меняется только базовый URL.
| Операция | Метод и путь | Лимит запросов на аккаунт |
|---|---|---|
| Создать задачу | POST {base}/contents/generations/tasks | RPM модели (180 или 600) |
| Получить одну задачу | GET {base}/contents/generations/tasks/{id} | 20 QPS |
| Список задач | GET {base}/contents/generations/tasks?page_num=1&page_size=20&filter.status=… | 1 QPS |
| Отменить или удалить | DELETE {base}/contents/generations/tasks/{id} | 20 QPS |
Опрашивайте задачи по ID. Список с лимитом 1 запрос в секунду для опроса не подходит: при нескольких задачах он быстро упрётся в лимит. Документация: создание задачи, получение задачи, список, отмена и удаление.
Эндпоинт текст-в-видео
Текст-в-видео — это тот же POST /contents/generations/tasks, в котором content[] содержит только текстовый элемент. Минимальный рабочий запрос на BytePlus:
curl -s https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "dreamina-seedance-2-5-260628",
"content": [
{"type": "text", "text": "A paper boat drifts down a rain-soaked street at dusk, slow tracking shot, soft city noise"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"generate_audio": true
}'В ответ приходит только ID задачи: {"id":"cgt-…"}. Статус проверяется запросом по этому ID:
curl -s https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks/cgt-XXXXXXXX \
-H "Authorization: Bearer $ARK_API_KEY"Для Volcengine замените базовый URL на https://ark.cn-beijing.volces.com/api/v3, а модель — на doubao-seedance-2-5-260628.
Промпт пишите по-английски. Все модели понимают английский; Seedance 2.5 дополнительно принимает испанский, индонезийский, португальский, японский, малайский, тайский, арабский, вьетнамский и корейский, Seedance 2.0 — испанский, индонезийский, португальский и японский. Русского в списке поддерживаемых языков нет. Рекомендуемая длина — до 1 000 английских слов.
Параметры верхнего уровня для моделей 2.x:
| Параметр | Значения и умолчание | Где действует |
|---|---|---|
resolution | 480p, 720p, 1080p; по умолчанию 720p; 4k — только Seedance 2.0 | Fast и Mini — только 480p и 720p |
ratio | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive; по умолчанию adaptive | на 2.5 при первом кадре, первом и последнем кадре, редактировании и продлении — только adaptive |
duration | 2.5: от 4 до 30 или -1, по умолчанию -1; 2.0: от 4 до 15 или -1, на BytePlus по умолчанию 5 | при -1 длину выбирает модель, а значит, и стоимость |
generate_audio | по умолчанию true, звук стерео | 2.5 и 2.0 |
watermark | по умолчанию false; true добавляет «AI Generated» в правом нижнем углу | все модели |
output_format | mp4 (по умолчанию) или mov | только 2.5 |
return_last_frame | по умолчанию false; true добавляет в ответ content.last_frame_url (JPEG) | все модели |
draft | по умолчанию false; true создаёт черновик 480p | только 2.5 |
callback_url | адрес, куда приходит POST при каждой смене статуса | все модели |
execution_expires_after | от 3600 до 259200 секунд, по умолчанию 172800 (48 часов); после срока задача получает статус expired | все модели |
priority | от 0 до 9, по умолчанию 0 | 2.5 и 2.0 |
safety_identifier | строка до 64 символов | все модели |
omni_reference_task_type | auto (по умолчанию), reference, edit, extend | только 2.5 |
tools | [{"type": "web_search"}] | только Volcengine, 2.5 и 2.0 |
Чего на моделях 2.x нет: seed и camera_fixed (они остались только у 1.0), frames, а также service_tier: "flex" — его запрос вернёт InvalidParameter.UnsupportedParameter. Поле seed при этом приходит в ответе, но задать его в запросе к 2.x нельзя.
Самая частая причина неожиданного счёта — duration. На Seedance 2.5 значение по умолчанию -1: модель сама выбирает длину в пределах до 30 секунд. Если бюджет считается на ролик, передавайте duration явно.
Черновик на Seedance 2.5 работает в два шага. Сначала задача с "draft": true — это ролик 480p, который оплачивается как обычный 480p. Затем финальная задача, в которой content содержит только {"type": "draft_task", "draft_task": {"id": "<ID черновика>"}}, а resolution равно "1080p". Повторно передавать текст, медиа, duration, ratio или generate_audio нельзя: запрос вернёт ошибку, даже если значения совпадают. ID черновиков, созданных начиная с 28 октября 2026 года, действуют 14 дней. Подробно: Seedance 2.5 на BytePlus.
Эндпоинт изображение-в-видео
Отдельного эндпоинта изображение-в-видео тоже нет: изображения, видео и аудио добавляются элементами в тот же content[], а назначение каждого файла задаёт поле role. Возможны три сценария, и смешивать их в одном запросе нельзя:
| Сценарий | Что передать |
|---|---|
| Первый кадр | одно изображение с "role": "first_frame" (или без role) |
| Первый и последний кадр | два изображения с "role": "first_frame" и "role": "last_frame" |
| Мультимодальные референсы | изображения reference_image, видео reference_video, аудио reference_audio |
Пример элемента изображения: {"type": "image_url", "image_url": {"url": "https://…/frame.png"}, "role": "first_frame"}. Видео и аудио передаются так же через video_url и audio_url.
Ограничения на входные файлы:
| Seedance 2.5 | Seedance 2.0, Fast, Mini | |
|---|---|---|
| Референсные изображения | до 30 | до 9 |
| Референсные видео | до 10, каждое от 2 до 30 секунд, вместе не больше 30 секунд | до 3, каждое от 2 до 15 секунд, вместе не больше 15 секунд |
| Референсное аудио | до 10, вместе не больше 30 секунд; можно без изображений и видео | до 3, вместе не больше 15 секунд; нужно хотя бы одно изображение или видео |
Изображение: JPEG, PNG, WebP, BMP, TIFF или GIF, меньше 30 МБ, стороны от 300 до 6000 пикселей, соотношение сторон от 0,4 до 2,5. Его можно передать ссылкой, в Base64 как data:image/png;base64,… (формат строчными буквами) или ID ассета asset://…. Видео (MP4 или MOV, до 200 МБ) передаётся только ссылкой или ID ассета, Base64 для видео не предусмотрен. Аудио — WAV или MP3 до 15 МБ. Всё тело запроса — не больше 64 МБ, поэтому крупные файлы лучше отдавать ссылкой.
Отдельное правило для лиц: Seedance 2.5 и 2.0 не принимают напрямую изображения и видео с реальными людьми. Разрешены ролики, созданные этими же моделями в вашем аккаунте за последние 30 дней, готовые цифровые персонажи asset:// и авторизованные ассеты реальных людей. Запрос с фото реального человека вне этих вариантов отклонит модерация с кодом, оканчивающимся на .PrivacyInformation.
Эндпоинт статуса и получения результатов
Статус задачи возвращает GET {base}/contents/generations/tasks/{id}. Поле status принимает шесть значений:
| Статус | Что значит | Что делать |
|---|---|---|
queued | задача в очереди | ждать; только в этом статусе задачу можно отменить через DELETE |
running | идёт генерация | ждать, отменить уже нельзя |
succeeded | видео готово | сразу скачать content.video_url и записать usage.completion_tokens |
failed | ошибка | прочитать error.code и error.message |
expired | истёк execution_expires_after | создать задачу заново, если ролик ещё нужен |
cancelled | отменена из очереди | запись удаляется через 24 часа |
Так выглядит успешный ответ из документации BytePlus (Seedance 2.5, 1080p, 5 секунд):
{
"id": "cgt-2025****",
"model": "dreamina-seedance-2-5-260628",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-ap-southeast-1.tos-ap-southeast-1.volces.com/****"
},
"usage": {"completion_tokens": 246840, "total_tokens": 246840},
"created_at": 1765510475,
"updated_at": 1765510559,
"seed": 58944,
"resolution": "1080p",
"ratio": "16:9",
"duration": 5,
"framespersecond": 24,
"service_tier": "default",
"execution_expires_after": 172800
}Сроки, которые важны для кода:
video_urlиlast_frame_urlдействуют 24 часа. Ссылку на ролик Seedance 2.5 можно скачать не больше 100 раз, поэтому сохраняйте файл в своё хранилище, а не раздавайте исходную ссылку пользователям.- ID задачи можно запрашивать 7 дней после
created_at. - Если опрос неудобен, передайте
callback_url: платформа пришлёт POST с тем же телом, что и у ответаGET, при каждой смене статуса, а уведомления оsucceededиfailedповторит до трёх раз, если ваш сервер не ответит за 5 секунд. - Для некоторых задач Seedance 2.5 ошибка в параметрах всплывает только после того, как задача вышла из очереди. Тогда
POSTпроходит успешно, а ошибка приходит позже вerrorсо статусомfailed. Проверяйте результат каждой задачи, а не только ответ на создание.
Как получить API-ключ Seedance 2.0 (3 способа)
Три способа остались, но выглядят иначе, чем в феврале 2026 года: официальный API давно работает, и вопрос теперь в том, какая консоль вам доступна. Во всех трёх случаях ключ передаётся одинаково — в заголовке Authorization: Bearer <ключ>.
Способ 1: BytePlus ModelArk (международный аккаунт). Зарегистрируйте аккаунт BytePlus, создайте API-ключ в консоли ModelArk и активируйте нужную модель Seedance. Для активации 2.5, 2.0, Fast и Mini достаточно любого из трёх вариантов: кредиты от $30, отдельный AI Savings Plan от $30 или пакеты ресурсов модели от $30. В кратком руководстве по Seedance 2.5 сказано, что нужен именно пакет ресурсов, но страница активации допускает любой из трёх вариантов. Кредиты не выводятся, а план и пакеты нельзя отменить. Списание идёт в порядке «пакет ресурсов → AI Savings Plan → баланс». Оплачивать счёт можно привязанным способом оплаты с автосписанием или кредитами, которые покупаются онлайн от $5 или банковским переводом.
Способ 2: Volcengine Ark (аккаунт в материковом Китае). Консоль 火山方舟 открывает те же модели с ID doubao-seedance-…. Нужны баланс, план экономии или пакет ресурсов от 200 юаней и верификация по реальному имени. Пока модель включена, до 200 юаней баланса нельзя вывести. Неиспользованный пакет ресурсов можно вернуть в течение 7 дней.
Способ 3: посредник с форматом Ark. Некоторые сервисы перепродают доступ и сохраняют тело запроса Ark. Например, laozhang.ai принимает запросы на https://api.laozhang.ai/seedance/api/v3 по тем же путям /contents/generations/tasks с ID Volcengine (doubao-seedance-2-5-260628, 2.0, Fast и Mini; Flash там пока нет). Ключ должен входить в группу SeeDance2, иначе запрос вернёт ошибку об отсутствии канала. Эндпоинта списка задач там нет, а если video_url недоступна, файл можно забрать через GET https://api.laozhang.ai/v1/videos/{id}/content. Запросы, отклонённые с кодом 4xx, не оплачиваются, неудачные и просроченные задачи возвращаются. Цена примерно в 1,2 раза выше прайса Volcengine. У других посредников свои форматы API и свои ID; их цены собраны в сравнении провайдеров Seedance API по цене и стабильности.
Можно ли подключить Seedance API из России
Напрямую через BytePlus — нет. На странице доступности ModelArk перечислено около 190 стран и регионов, где работает сервис моделей, и России в этом списке нет. Нет там также Беларуси, Украины, США, Индии и материкового Китая. Казахстан, Узбекистан, Армения и Грузия в списке есть, но BytePlus оговаривает, что доступность в конкретной стране определяется в момент покупки. Volcengine рассчитан на аккаунты материкового Китая и требует верификации по реальному имени.
Поэтому из России Seedance обычно подключают через посредника. Посредник с форматом Ark (способ 3) позволяет использовать код из этого руководства почти без изменений: меняются только базовый URL, ключ и ID модели (doubao-). Российские шлюзы принимают оплату в рублях, но у каждого свой API, а их цены сравниваются в материале о провайдерах Seedance API.
Есть ли бесплатный доступ к Seedance API
Постоянного бесплатного тарифа у официального Seedance API нет. Новые аккаунты BytePlus получают бесплатную квоту инференса отдельно на каждую модель, а режим Free Tokens Only ограничивает расход 500 000 бесплатных токенов. Сколько из этого приходится на Seedance 2.x, документация не указывает. Для ориентира: один ролик 720p 16:9 на 10 секунд — это 216 000 токенов. Когда квота кончается, API возвращает 429 QuotaExceeded с сообщением об исчерпанной пробной квоте, и дальше нужна платная активация от $30. На Volcengine размер бесплатной квоты виден только в консоли, а после её исчерпания нужны верификация по реальному имени и ручное включение модели.
Лимиты, квоты и разбор цен
Официальные лимиты опубликованы, и оценки больше не нужны. Лимит считается на основной аккаунт и на модель:
| Модель | RPM (корпоративный / личный) | Одновременных задач (корпоративный / личный) |
|---|---|---|
| Seedance 2.5 | 600 / 180 | 10 / 3 |
| Seedance 2.0 (кроме 4k) | 600 / 180 | 10 / 3 |
| Seedance 2.0 в 4k | 15 для всех | 1 для всех |
| Seedance 2.0 Fast и Mini | 600 / 180 | 10 / 3 |
| Seedance 2.5 Flash | не опубликованы | не опубликованы |
Источник: список моделей BytePlus, на Volcengine цифры те же.
Два лимита ведут себя по-разному. Если превысить RPM, запрос на создание завершится ошибкой 429. Если превысить число одновременных задач, ошибки не будет: новые задачи встанут в очередь. Очередь при этом не бесконечна: при переполнении API вернёт 429 QuotaExceeded с текстом о превышении числа задач в статусе queued, но конкретное число документация не называет. Отдельно действуют лимиты на служебные запросы: 20 QPS на получение задачи, 1 QPS на список и 20 QPS на отмену или удаление. На Volcengine онлайн-лимиты прямо названы негарантированными: они зависят от нагрузки на платформу.
Тарифные планы (ориентировочно)
Ориентировочные тарифы больше не нужны: Seedance оплачивается по токенам по опубликованному прайсу, а фиксированных тарифов за ролик или минуту нет. Число токенов оценивается по формуле из прайса BytePlus:
токены ≈ (секунды входного видео + секунды выходного видео) × ширина × высота × 24 / 1024
Пример для Seedance 2.5, 720p 16:9 (1280 × 720), 10 секунд без входного видео: 10 × 1280 × 720 × 24 / 1024 = 216 000 токенов. По прайсу BytePlus на 14 ноября 2026 года ($10,70 за 1 млн токенов при 480p и 720p без входного видео) это примерно $2,31.
Что ещё влияет на сумму:
- Оплачиваются только успешно сгенерированные видео. Задачи, отклонённые модерацией, бесплатны.
- Если на входе есть видео, цена за токен ниже, но действует минимальный расход токенов.
- Звук (
generate_audio) на моделях 2.x не стоит дополнительно. - Формула даёт оценку, а в счёт идёт
usage.completion_tokensиз ответа.
Кросс-платформенное сравнение цен
Одна и та же модель на разных площадках стоит по-разному. По состоянию на 14 ноября 2026 года ролик Seedance 2.5 на 10 секунд в 720p стоил от $2,31 по прайсу BytePlus до вдвое большей суммы у самого дорогого из сравниваемых перепродавцов, а Volcengine считает в юанях по своему прайсу. Таблица по провайдерам с датами — в сравнении провайдеров Seedance API. Цены других видеомоделей рядом с Seedance — в разделе о Veo 3.1, Kling 4.0 и Gemini Omni ниже.
Как проверить списание по usage.completion_tokens
Чтобы счёт не стал сюрпризом, сравнивайте usage.completion_tokens каждой успешной задачи с оценкой по формуле. Небольшое расхождение нормально: кадров может быть на один больше, чем 24 × секунды, а это уже +0,4 %. В примере из документации выше 1080p на 5 секунд дали 246 840 токенов при оценке 243 000, то есть на 1,6 % больше. Если разница заметно больше нескольких процентов, проверьте фактическую длительность: при duration: -1 её выбирает модель, а поле duration в ответе показывает реальную длину в секундах с округлением вниз.
# Размеры кадра 16:9 по справочнику BytePlus: 480p — 854x480 (2.5) или 864x496 (2.0),
# 720p — 1280x720, 1080p — 1920x1080. Для других соотношений берите размер своего ролика.
def estimate_tokens(width: int, height: int, out_seconds: int, in_video_seconds: int = 0) -> int:
return round((in_video_seconds + out_seconds) * width * height * 24 / 1024)
def check_billing(task: dict, width: int, height: int, price_per_million: float) -> None:
billed = task["usage"]["completion_tokens"]
estimate = estimate_tokens(width, height, task["duration"])
print(f"списано токенов: {billed}, оценка: {estimate}, "
f"разница: {(billed - estimate) / estimate:+.1%}, "
f"сумма: ${billed * price_per_million / 1_000_000:.2f}")
# check_billing(task, 1280, 720, 10.70) # Seedance 2.5, 720p, прайс BytePlus на 14.11.2026Полный Python-код интеграции
Код ниже использует официальный формат Ark и библиотеку requests, поэтому работает с BytePlus, Volcengine и посредником с тем же форматом. Меняются три переменные окружения:
| Куда отправлять | ARK_BASE_URL | SEEDANCE_MODEL |
|---|---|---|
| BytePlus ModelArk | https://ark.ap-southeast.bytepluses.com/api/v3 | dreamina-seedance-2-5-260628 |
| Volcengine Ark | https://ark.cn-beijing.volces.com/api/v3 | doubao-seedance-2-5-260628 |
| laozhang.ai | https://api.laozhang.ai/seedance/api/v3 | doubao-seedance-2-5-260628 |
Ключ кладётся в ARK_API_KEY. Если вам удобнее официальный SDK, установите arkruntime (pip install --upgrade arkruntime): в нём те же операции вызываются как client.content_generation.tasks.create, .get, .list и .delete.
Генерация текст-в-видео
Скрипт создаёт задачу, опрашивает её по ID, при успехе сразу скачивает ролик и печатает списанные токены. Срок жизни задачи задан через execution_expires_after, чтобы застрявшая в очереди задача завершилась статусом expired сама, а не сгенерировалась и не оплатилась через сутки после того, как скрипт перестал её ждать.
import os
import time
import requests
BASE_URL = os.environ.get("ARK_BASE_URL", "https://ark.ap-southeast.bytepluses.com/api/v3" )
API_KEY = os.environ["ARK_API_KEY"]
MODEL = os.environ.get("SEEDANCE_MODEL", "dreamina-seedance-2-5-260628")
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
TASKS_URL = f"{BASE_URL}/contents/generations/tasks"
FINAL_STATUSES = {"succeeded", "failed", "expired", "cancelled"}
TASK_TTL = 7200 # секунд; допустимо от 3600 до 259200
def create_task(body: dict, attempts: int = 5) -> str:
"""Создаёт задачу и возвращает её ID. Повторяет только 429 и 500."""
for attempt in range(attempts):
r = requests.post(TASKS_URL, headers=HEADERS, json=body, timeout=60)
if r.status_code in (429, 500):
# 429 из-за RPM проходит сам; QuotaExceeded из-за пробной квоты
# и SetLimitExceeded повтором не лечатся — смотрите текст ответа.
print(f"HTTP {r.status_code}, повтор: {r.text[:200]}")
time.sleep(min(60, 5 * 2 ** attempt))
continue
if r.status_code >= 400:
raise RuntimeError(f"HTTP {r.status_code}: {r.text}")
return r.json()["id"]
raise RuntimeError("Задача не создана: лимит повторов исчерпан")
def wait_for_task(task_id: str, interval: int = 15, max_wait: int = TASK_TTL + 600) -> dict:
"""Опрашивает задачу по ID, пока она не перейдёт в конечный статус."""
deadline = time.time() + max_wait
while time.time() < deadline:
r = requests.get(f"{TASKS_URL}/{task_id}", headers=HEADERS, timeout=30)
if r.status_code in (429, 500):
time.sleep(interval)
continue
r.raise_for_status()
task = r.json()
if task["status"] in FINAL_STATUSES:
return task
time.sleep(interval)
raise TimeoutError(f"{task_id}: нет конечного статуса за {max_wait} с")
def download(url: str, path: str) -> str:
"""Скачивает ролик сразу: ссылка живёт 24 часа."""
with requests.get(url, stream=True, timeout=300) as r:
r.raise_for_status()
with open(path, "wb") as f:
for chunk in r.iter_content(chunk_size=1 << 20):
f.write(chunk)
return path
def generate(prompt: str, path: str, duration: int = 10, resolution: str = "720p",
ratio: str = "16:9", extra_content: list | None = None) -> dict:
body = {
"model": MODEL,
"content": [{"type": "text", "text": prompt}] + (extra_content or []),
"resolution": resolution,
"ratio": ratio,
"duration": duration, # задайте явно: на 2.5 по умолчанию -1
"generate_audio": True,
"watermark": False,
"execution_expires_after": TASK_TTL,
}
task_id = create_task(body)
print(f"создана задача {task_id}")
task = wait_for_task(task_id)
if task["status"] != "succeeded":
error = task.get("error") or {}
raise RuntimeError(f"{task_id}: {task['status']} {error.get('code')} {error.get('message')}")
download(task["content"]["video_url"], path)
print(f"{path}: {task['duration']} с, токенов списано {task['usage']['completion_tokens']}")
return task
if __name__ == "__main__":
generate(
"A serene mountain lake at sunrise, mist rising from the water, "
"drone shot slowly revealing the forest, cinematic lighting",
"lake.mp4",
)Интервал опроса 15 секунд выбран с запасом: лимит на получение задачи — 20 запросов в секунду на аккаунт, так что даже десятки параллельных задач в него укладываются. Если ваш сервер доступен из интернета, вместо опроса можно передать callback_url.
Генерация изображение-в-видео с мультимодальными ссылками
Этот и следующий фрагменты дополняют тот же файл: функция generate из предыдущего примера принимает дополнительные элементы content[], а два вызова ниже показывают сценарии из таблицы выше. Локальное изображение кодируется в Base64; видео так передать нельзя, только ссылкой или ID ассета.
import base64
from pathlib import Path
def image_data_url(path: str) -> str:
fmt = Path(path).suffix.lstrip(".").lower()
fmt = "jpeg" if fmt == "jpg" else fmt
data = base64.b64encode(Path(path).read_bytes()).decode("ascii")
return f"data:image/{fmt};base64,{data}"
# Сценарий 1: изображение как первый кадр. На Seedance 2.5 ratio здесь только adaptive.
generate(
"The woman in the red coat turns and walks toward the camera, slow dolly in",
"first_frame.mp4",
duration=5,
ratio="adaptive",
extra_content=[
{"type": "image_url", "image_url": {"url": image_data_url("frame.png")}, "role": "first_frame"},
],
)
# Сценарий 3: референсы — два изображения товара и звуковая дорожка по ссылке.
generate(
"Product spin of the sneaker from the reference images, studio light, beat-synced cuts",
"product.mp4",
duration=8,
ratio="9:16",
extra_content=[
{"type": "image_url", "image_url": {"url": "https://example.com/shoe-side.png"}, "role": "reference_image"},
{"type": "image_url", "image_url": {"url": "https://example.com/shoe-top.png"}, "role": "reference_image"},
{"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"},
],
)Не смешивайте first_frame и reference_image в одном запросе: это разные сценарии. Если на фото или видео есть реальный человек, запрос отклонит модерация (см. правило для лиц в разделе об эндпоинте изображение-в-видео).
Пакетная обработка с контролем параллелизма
Фрагмент использует generate, os и Path из предыдущих примеров. Число потоков в пакетной генерации стоит держать равным лимиту одновременных задач: 3 для личного аккаунта, 10 для корпоративного, 1 для Seedance 2.0 в 4k. Задачи сверх лимита не упадут, но будут стоять в очереди, а переполненная очередь вернёт QuotaExceeded. При трёх потоках и роликах длиной в минуты лимит 180 запросов на создание в минуту недостижим.
from concurrent.futures import ThreadPoolExecutor, as_completed
MAX_CONCURRENT = int(os.environ.get("SEEDANCE_CONCURRENCY", "3")) # 3 личный, 10 корпоративный
def batch_generate(prompts: list[str], out_dir: str = "videos") -> list[dict]:
Path(out_dir).mkdir(parents=True, exist_ok=True)
results = []
with ThreadPoolExecutor(max_workers=MAX_CONCURRENT) as pool:
futures = {
pool.submit(generate, prompt, f"{out_dir}/video_{i:03d}.mp4"): i
for i, prompt in enumerate(prompts)
}
for future in as_completed(futures):
i = futures[future]
try:
task = future.result()
results.append({"index": i, "id": task["id"],
"tokens": task["usage"]["completion_tokens"]})
except Exception as exc: # ошибка одной задачи не останавливает пакет
results.append({"index": i, "error": str(exc)})
return sorted(results, key=lambda item: item["index"])Каждый поток опрашивает свою задачу по ID. Опрос через список задач здесь не годится: его лимит — 1 запрос в секунду на весь аккаунт.
Устранение типичных проблем с API: официальные коды ошибок Ark
Ошибки приходят двумя путями: сразу в ответ на POST (HTTP-код и код ошибки) или позже в поле error задачи со статусом failed. Основные коды для видеозадач по справочнику ошибок BytePlus и Volcengine:
| HTTP | Код | Что случилось | Что делать |
|---|---|---|---|
| 400 | MissingParameter, InvalidParameter | нет обязательного поля или значение недопустимо | исправить тело; повтор не поможет |
| 400 | InvalidParameter.UnsupportedParameter | параметр не поддерживается этой моделью (например, service_tier: "flex" на 2.x) | убрать параметр |
| 400 | InvalidParameter.TaskTypeConstraint, InvalidParameter.TaskTypeMismatch | параметры не подходят к типу задачи, который определила Seedance 2.5, или он не совпал с omni_reference_task_type | для редактирования и продления — ratio: "adaptive", для редактирования — duration: -1 |
| 400 | InvalidEndpoint.ClosedEndpoint | эндпоинт закрыт или временно недоступен | проверить эндпоинт в консоли |
| 400 | Input…SensitiveContentDetected, Output…SensitiveContentDetected | модерация входа или результата; суффикс .PolicyViolation — авторские права, .PrivacyInformation — реальный человек | изменить промпт или файл; такие задачи не оплачиваются |
| 400 | InvalidImageURL.EmptyURL, InvalidImageURL.InvalidFormat | пустой или нечитаемый Base64 | проверить строку data:image/…;base64, |
| 401 | AuthenticationError | ключ отсутствует или неверен | проверить ключ и заголовок Authorization |
| 403 | AccountOverdueError, OperationDenied.ServiceOverdue | отрицательный баланс или неоплаченный счёт | пополнить счёт |
| 403 / 404 | OperationDenied.ServiceNotOpen, ModelNotOpen | модель не активирована в аккаунте | активировать модель (от $30 или 200 юаней) |
| 404 | InvalidEndpointOrModel.NotFound | модели или эндпоинта нет, или к ним нет доступа | сверить ID: dreamina- на BytePlus, doubao- на Volcengine |
| 404 | InvalidEndpointOrModel.ModelIDAccessDisabled | аккаунт должен вызывать модель через Endpoint ID | передать в model ID эндпоинта |
| 429 | ModelAccountRpmRateLimitExceeded, RateLimitExceeded.EndpointRPMExceeded, APIAccountRpmRateLimitExceeded | превышен RPM | подождать и повторить с паузой |
| 429 | ModelAccountConcurrentRequestsLimitExceeded (Volcengine), InflightBatchsizeExceeded (BytePlus) | превышена параллельность (на BytePlus — для текущей суммы пополнения) | уменьшить число одновременных задач |
| 429 | QuotaExceeded | переполнена очередь задач queued или исчерпана пробная квота модели | в первом случае дождаться завершения задач, во втором — активировать модель |
| 429 | SetLimitExceeded | сработал лимит режима безопасного использования (Safe Experience Mode), модель приостановлена | изменить лимит в консоли |
| 429 | ServerOverloaded, RequestBurstTooFast, AccountRateLimitExceeded | перегрузка или слишком резкий всплеск запросов | повторить с нарастающей паузой |
| 500 | InternalServiceError | внутренняя ошибка | повторить позже |
Если в логах встречается «too many concurrent requests», по-русски это «слишком много одновременных запросов». В Ark за параллельность отвечают два кода из таблицы: ModelAccountConcurrentRequestsLimitExceeded на Volcengine и InflightBatchsizeExceeded на BytePlus. Лечится одинаково: уменьшить число одновременных задач до лимита аккаунта. Сам по себе выход за 3 или 10 одновременных задач на BytePlus ошибкой не считается, задачи просто ждут в очереди.
Три проблемы, которые таблица не покрывает:
- Код после отключения модели. Если в коде остался
seedance-1-5-pro-251215, замените ID наdreamina-seedance-2-0-mini-260615или другую модель 2.x. Какой именно код вернёт запрос к отключённой модели, документация не уточняет. - Ссылка на видео не открывается.
video_urlдействует 24 часа, а у Seedance 2.5 ещё и не больше 100 скачиваний. Скачивайте файл сразу послеsucceededи раздавайте копию из своего хранилища. - Формат синхронной ошибки. Структура JSON при HTTP-ошибке на
POSTдля видео-API в документации не приведена; описан только объектerrorс полямиcodeиmessageв задаче. Логируйте тело ответа целиком.
Seedance против Veo 3.1, Kling 4.0 и Gemini Omni: цена 10 секунд 720p

Sora 2 из этого сравнения выпала: OpenAI закрыла приложение Sora 26 апреля 2026 года, а Sora 2 API отключила 24 сентября 2026 года. Подробнее о том, чем её заменяют, — в материале Sora 2 API закрыт: самые дешёвые замены и цена за секунду. Из живых альтернатив Seedance 2.5 при 720p стоит дороже Veo 3.1 Fast, Kling 4.0 и Gemini Omni 1.2 Flash, но дешевле Veo 3.1 Standard:
| Модель и площадка | За секунду 720p | 10 секунд 720p | Цена по состоянию на |
|---|---|---|---|
| Seedance 2.5, BytePlus | ≈ $0,231 | $2,31 | 14 ноября 2026 года |
| Seedance 2.0, BytePlus | ≈ $0,15 | $1,51 | 14 ноября 2026 года |
| Veo 3.1 Standard, Google Cloud, со звуком | $0,40 | $4,00 | 5 ноября 2026 года |
| Veo 3.1 Fast, Google Cloud, со звуком | $0,10 | $1,00 | 5 ноября 2026 года |
| Kling 4.0, официальный API | $0,157 | $1,57 | 6 ноября 2026 года |
| Gemini Omni 1.2 Flash, Gemini API | ≈ $0,07 | ≈ $0,70 | 12 ноября 2026 года |
Seedance считается по токенам (16:9, без входного видео), остальные — по секундам из прайсов их платформ; это прайсовые цены одной генерации, а не стоимость пригодного ролика с учётом переделок. Seedance 2.5 Flash по прайсу BytePlus стоит при 720p столько же, сколько 2.0, но её параметры и лимиты пока не опубликованы.
Для разработчика важнее цены то, что у Seedance отличается в самом API: до 30 секунд в одном запросе на 2.5, до 30 референсных изображений плюс видео и аудио, звук по умолчанию и черновик 480p перед финальным 1080p. Если какой-то из этих пунктов нужен продукту, сравнение по цене за секунду вторично. Отдельное сравнение с моделью Google — в материале Seedance 2.5 или Gemini Omni: какую модель тестировать первой.
Журнал изменений Seedance API: от анонса 2.0 до 2.5 Flash
Подтверждённые события с датами:
| Дата | Что изменилось |
|---|---|
| Февраль 2026 года | ByteDance анонсировала Seedance 2.0 |
| 7 августа — 7 октября 2026 года | на BytePlus действовала скидка на 2.0 Fast и Mini для корпоративных аккаунтов; она закончилась |
| 28 октября 2026 года, 10:00 по UTC+8 | ID черновиков Seedance 2.5, созданных с этого момента, действуют 14 дней вместо 7 |
| 11 ноября 2026 года, 17:00 по UTC+8 | BytePlus отключил seedance-1-5-pro-251215 без автоматического переноса; рекомендованная замена — dreamina-seedance-2-0-mini-260615 |
| 15 ноября 2026 года, 14:00 по UTC+8 | открываются вызовы API Seedance 2.5 Flash: dreamina-seedance-2-5-flash-261115 на BytePlus, в прайсе Volcengine — doubao-seedance-2.5-flash |
| Дата не объявлена | на Volcengine Seedance 1.0 Pro и 1.0 Pro Fast помечены как скоро отключаемые |
Если вы ещё вызываете модели 1.x, начните перенос на 2.x: формат запроса тот же, но seed, camera_fixed и frames на 2.x не поддерживаются, ratio по умолчанию равен adaptive, а на Seedance 2.5 и duration по умолчанию равен -1.
Часто задаваемые вопросы
Доступен ли официально Seedance 2.0 API?
Да. Seedance 2.0, 2.0 Fast, 2.0 Mini и Seedance 2.5 работают через официальный Ark API на BytePlus ModelArk (ID dreamina-seedance-…) и Volcengine Ark (ID doubao-seedance-…). Нужны API-ключ и активация модели: от $30 на BytePlus или от 200 юаней на Volcengine. Из России BytePlus недоступен по его собственному списку стран, поэтому остаётся посредник.
Сколько стоит генерация одного видео через Seedance 2.0 API?
Оплата идёт по токенам: (секунды видео) × ширина × высота × 24 / 1024. По прайсу BytePlus на 14 ноября 2026 года 10 секунд 720p 16:9 стоят около $1,51 на Seedance 2.0 и около $2,31 на Seedance 2.5. Фактическая сумма — usage.completion_tokens из ответа, умноженное на цену за токен. Цены у разных провайдеров — в сравнении провайдеров Seedance API.
Можно ли использовать один и тот же код для Seedance 2.0 и Sora 2?
Нет. OpenAI отключила Sora 2 API 24 сентября 2026 года, так что вызвать её через API больше нельзя. К тому же Ark API Seedance с OpenAI не совместим: у него свой путь /contents/generations/tasks, массив content[] вместо одного поля с промптом и свои статусы. Общей остаётся только схема «создать задачу → опрашивать → скачать», поэтому при работе с несколькими видеомоделями пишите для каждого провайдера свой адаптер.
Что происходит, если генерация видео завершается неудачей?
Задача получает статус failed, а в поле error приходят code и message. На BytePlus и Volcengine оплачиваются только успешно сгенерированные видео; задачи, отклонённые модерацией, бесплатны. Повторять имеет смысл ошибки 429 из-за RPM и 500; ошибки параметров и модерации нужно исправлять, а не повторять. У посредников свои правила возврата, их стоит проверить до запуска.
Сколько времени занимает генерация видео?
Официальных цифр по скорости нет. В примере из документации BytePlus задача Seedance 2.5 на 5 секунд в 1080p прошла от создания до последнего обновления за 84 секунды, но это один пример, а не гарантия. Если все слоты параллельности заняты, задача сначала ждёт в очереди. Поэтому задавайте execution_expires_after (от 1 до 72 часов, по умолчанию 48) и опрашивайте задачу, пока она не перейдёт в конечный статус, а не обрывайте ожидание через пять минут.
Нужен ли депозит $1 млн, чтобы получить Seedance API?
Нет. Ни одна страница BytePlus или Volcengine такого требования не содержит. Официальный порог для Seedance 2.x — $30 на BytePlus или 200 юаней на Volcengine. Отдельно BytePlus продаёт корпоративные Advanced Creation Rights ($14 000 в год) для приватных библиотек ассетов и работы с реальными людьми, но для обычных вызовов API они не нужны.
Можно ли уже вызвать Seedance 2.5 Flash через API?
С 15 ноября 2026 года, 14:00 по UTC+8 — да, на BytePlus под ID dreamina-seedance-2-5-flash-261115. В прайсе для неё указаны только 480p и 720p, а параметры, ограничения и лимиты запросов в справочнике API пока не описаны. Версионный ID Flash на Volcengine не опубликован; в прайсе она значится как doubao-seedance-2.5-flash.






