SeeDance2, оплата идёт за токены.
Настройка токена
Модели Seedance доступны только в группе
SeeDance2, поэтому токен должен принадлежать ей. Токены других групп, например default или Wan, эти модели вызвать не могут: запрос завершится ошибкой «нет канала». Отдельный токен для Seedance к тому же упрощает проверку журнала и списаний.
Эндпоинты
GET /contents/generations/tasks без ID задачи: на этом шлюзе список возвращает HTML сайта, а не JSON. Создайте задачу и затем запрашивайте каждую по её ID.
Оплата и цены
Seedance оплачивается за токены по списочной цене Volcengine Ark плюс 20%. Надбавка покрывает налоги, конвертацию валют и трансграничные расчёты, эксплуатацию платформы и техническую поддержку. С 14 октября 2026 года цена пересчитывается так:- цена в долларах = списочная цена Volcengine в юанях × 0.1714 (множитель группы
SeeDance2) - при фиксированном курсе 1:7 получается 0.1714 × 7 ≈ 1.2, то есть вы платите около 1.2× от списочной цены
Списочные цены взяты со страницы цен на модели Volcengine Ark (на китайском). Модели fast и mini поддерживают разрешение до 720p.
Примерная стоимость одного видео 16:9 с 5 секундами на выходе и без входного видео, по 121 реально выведенному кадру (около 108 900 токенов при 720p и 245 025 токенов при 1080p):
- Seedance 2.5: около $1.31 при 720p и $3.23 при 1080p
- Seedance 2.0: около $0.86 при 720p и $2.14 при 1080p
- fast: около $0.69 при 720p
- mini: около $0.43 при 720p
usage.completion_tokens задачи, а стоимость задачи — это сумма двух её строк в журнале вызовов. Цены моделей есть и на странице цен в консоли, а группы и множители — в разделе Модели и цены.
В деталях задачи множитель может отображаться как topup_convert_ratio: 0.1714 рядом с group_ratio: 1. Эти поля выполняют разные функции: group_ratio: 1 не означает, что множитель не применялся.
Оценка стоимости задачи
Volcengine публикует такую формулу для оценки стоимости:- Токен при 1080p стоит дороже, чем при 480p и 720p; см. таблицу выше.
- Запрос с входным видео (
video_url) имеет более низкую цену за токен — это значения «с видео» в таблице. Но длительность входного видео тоже входит в расход токенов, поэтому те же 5 секунд на выходе обычно обходятся дороже. - Для запросов с входным видео Volcengine устанавливает минимальный расход токенов и списывает этот минимум, если оценка получается ниже.
- Чем длиннее выход, тем больше токенов. В Seedance 2.5 по умолчанию
durationравно-1: модель сама выбирает длину от 4 до 30 секунд, поэтому если важна стоимость, задавайтеdurationявно.
Каждый диапазон идёт от входного видео длиной 2–4 секунды до самого длинного допустимого: 30 секунд для Seedance 2.5 и 15 секунд для моделей 2.0.
Почему у одной задачи две строки в журнале вызовов
При создании задачи итоговое число токенов ещё неизвестно. LaoZhang API сначала записывает ориентировочное предварительное списание, а затем по итоговомуusage.completion_tokens проводит расчёт разницы. Обе строки относятся к одной задаче: это не два запроса и не два полных списания.
Стоимость задачи = сумма предварительного списания и расчёта. Например, предварительное списание около $0.90 и расчёт около $3.58 дают одну задачу стоимостью около $4.48. Если фактический расход меньше оценки, строка расчёта возвращает разницу.
Пометка «потоковая» в строке расчёта появляется из-за самого процесса расчёта. Она не означает, что ваш клиент использовал потоковый API, и не указывает на запрос с другого ключа. Строка расчёта обычно не повторяет токен, группу и IP, поэтому источник запроса определяйте по строке предварительного списания.
Чтобы сверить одну задачу:
- Найдите в журнале вызовов
doubao-seedanceили полный ID использованной модели. - По строке предварительного списания проверьте токен, группу и исходный IP.
- По строке расчёта посмотрите итоговое число токенов на выходе.
- Сопоставьте ID задачи, время создания и завершения на странице асинхронных задач и считайте две строки одним видео.
Как работает задача
1
Создайте задачу
Вызовите
POST /contents/generations/tasks: в model передайте обычный ID модели, а промпт и медиафайлы — в массив content. Сохраните возвращённый id.2
Опрашивайте задачу
Вызывайте
GET /contents/generations/tasks/{id}, пока status не станет конечным.3
Скачайте видео
После успешного завершения скачайте видео по
content.video_url или вызовите /v1/videos/{id}/content.Если вы передали return_last_frame со значением true, прочитайте также content.last_frame_url.Статусы задачи
Для всех ответов применяйте одно правило:
- Пока
statusравенqueuedилиrunning, продолжайте опрос. - Значения
succeededиcompletedсчитайте успехом. - Любое другое значение считайте конечным. При конечной ошибке прекратите опрос и сохраните ответ целиком в лог.
status и content.video_url. Если форма ответа другая:
- Объект задачи в формате LaoZhang может отдавать ссылку в поле верхнего уровня
result_urlили вdata.content.video_url. - Если ссылку найти не удалось, скачивайте видео через
/v1/videos/{id}/content.
Модели
ID моделей взяты из публичного прайс-листа LaoZhang API на 24 сентября 2026 года, а возможности mini и 2.5 — из сравнения моделей в руководстве Volcengine по Seedance 2.5 (на китайском). В Seedance 2.5 для задач с первым кадром, первым и последним кадрами, редактированием и продлением видео действуют дополнительные ограничения на
ratio и duration, поэтому перед переходом на 2.5 прочитайте это руководство.
В model передавайте обычный ID модели. Не используйте ID эндпоинта из консоли (ep-...) и не дописывайте к названию пометки вроде (2.0-audio-video): шлюз подбирает каналы по обычному ID модели.
Подготовка окружения
- В примерах для оболочки используются
curlиjq. Установить jq можно командойbrew install jqилиsudo apt-get install jq. - Для примера на Python нужен пакет
requests:pip install requests. - Каждый пример создания сохраняет ответ в
create.json, который затем читает шаг запроса статуса.
Текст в видео
Каждый запрос на создание отправляется наPOST /seedance/api/v3/contents/generations/tasks. Заголовки, параметры и элементы content описаны после примеров, в разделе «Создание задачи».
Первый и последний кадры
Референсы: изображение, видео и аудио
Active, передайте его URI asset://... как reference_image.
Запрос статуса задачи
create.json и проверьте задачу:
status равен queued или running. Успешный ответ выглядит так:
Скачивание результата
Authorization не нужен:
https://api.laozhang.ai/v1, а не под /seedance/api/v3. После успешного завершения задачи он находит сохранённый результат на сервере и возвращает MP4 или перенаправляет на него:
Пример на Python
Пример создаёт задачу «текст в видео», опрашивает её до 20 минут и сохраняет MP4. Зависимость устанавливается командойpip install requests.
Создание задачи
Заголовки
Параметры запроса
Элементы content
Основные значения
role:
В моделях Seedance 2.0 (standard, fast и mini) аудио не может быть единственным референсом: если вы передаёте
audio_url, добавьте в тот же запрос хотя бы одно изображение или видео. Seedance 2.5 принимает аудио как единственный референс.
Частые вопросы
Меня списали дважды за одну задачу Seedance?
Нет. Две строки — это предварительное списание и расчёт по одной задаче, а их сумма и есть стоимость задачи. Как их сверить, описано выше в подразделе про две строки журнала вызовов.Сколько стоит видео на 5 секунд?
По ценам на 14 октября 2026 года, для задачи 16:9 без входного видео и с выходом 5 секунд (121 кадр):- Seedance 2.5: около $1.31 при 720p, $3.23 при 1080p
- Seedance 2.0 standard: около $0.86 при 720p, $2.14 при 1080p
- fast: около $0.69 при 720p; mini: около $0.43 при 720p
usage.completion_tokens в результате задачи; формула приведена в подразделе «Оценка стоимости задачи».
Насколько Seedance 2.5 дороже 2.0?
Примерно в 1.5 раза за токен при том же разрешении: $12.00 против $7.88 за 1M токенов при 720p и $13.20 против $8.74 при 1080p, без входного видео. Одно и то же 5-секундное видео в 720p стоит около $1.31 на 2.5 и около $0.86 на 2.0. Что даёт 2.5 (ролики длиннее 15 секунд, больше референсных файлов, аудио как единственный референс, выход MOV), описано в вопросе о выборе модели ниже.Списывают ли деньги, если запрос отклонён или задача не выполнена?
Нет. Если запрос на создание отклонён сразу, например ошибкой параметров 4xx без ID задачи, списания нет. Если задача создана, но завершилась статусомfailed или expired, предварительное списание возвращается при расчёте задачи.
Фактическое списание видно в журнале вызовов. Если по неудавшейся или истёкшей задаче всё равно остался платёж, напишите в поддержку и укажите ID задачи.
Множитель группы SeeDance2 — это скидка?
Нет. Множитель 0.1714 переводит списочные цены Volcengine в юанях в доллары на вашем балансе и даёт около 1.2× от списочной цены; надбавка покрывает налоги, конвертацию валют и трансграничные расчёты, эксплуатацию платформы и техническую поддержку. Пересчёт и цены за токен — в разделе «Оплата и цены».
Почему 1080p дороже и дороже ли вертикальное видео?
1080p стоит дороже по двум причинам, а соотношение сторон почти не влияет. Во-первых, цена за токен выше (см. раздел «Оплата и цены»), во-вторых, расход токенов растёт вместе с числом пикселей на выходе. Пять секунд в 720p используют около 108 900 токенов, а пять секунд в 1080p — около 245 025, поэтому видео в 1080p обходится заметно дороже. При одном разрешении у всех соотношений сторон примерно одинаковое число пикселей: в 720p 16:9 — это 1280×720, а 9:16 — 720×1280. Горизонтальное, вертикальное и квадратное видео поэтому стоят примерно одинаково. Формула приведена в подразделе «Оценка стоимости задачи».Какой путь и значение model отправлять?
Отправляйте запросы на /seedance/api/v3/contents/generations/tasks. Если убрать /api из префикса (/seedance/v3/...), вместо JSON придёт HTML сайта; то же происходит при запросе списка без ID задачи.
В model передавайте обычный ID модели, например doubao-seedance-2-0-260128. Не передавайте ID эндпоинта ep-... и не добавляйте пометку после ID.
Какую модель выбрать: 2.0 standard, fast, mini или 2.5?
Выбирайте по нужной возможности:- 1080p: 2.0 standard или 2.5. Fast и mini ограничены 720p.
- Больше 15 секунд, больше 9 референсных изображений, аудио как единственный референс или выход MOV: 2.5. Модели 2.0 принимают до 9 изображений, 3 видео и 3 аудиоклипов.
- Самая низкая цена: у mini она самая низкая, fast находится между mini и standard. Внутри семейства 2.0 самое высокое качество у standard.
SeeDance2. Цены сравнивайте в разделе «Оплата и цены», а возможности — в разделе «Модели».
Почему в моём видео есть звук и как его отключить?
В Seedance 2.0 и 2.5generate_audio по умолчанию равно true, поэтому модель добавляет голоса, звуковые эффекты и фоновую музыку в соответствии с промптом и картинкой, в моно.
Чтобы получить видео без звука, передайте "generate_audio": false. Для реплик помогает заключить диалог в двойные кавычки.
Где итоговая ссылка на видео и сколько она действует?
В объекте задачи в стиле Ark этоcontent.video_url, ссылка действует 24 часа. Объект задачи в формате LaoZhang может вернуть её в поле верхнего уровня result_url или в data.content.video_url. Если нужен только файл, вызовите /v1/videos/{id}/content.
Volcengine хранит ссылку на видео 24 часа, а ссылку на видео Seedance 2.5 можно скачать не более 100 раз. Скачайте видео сразу после успешного завершения задачи, храните его у себя и отдавайте пользователям собственную ссылку.