Skip to main content

​
Обзор

doubao-seedance-2-5-260628 (2.5), doubao-seedance-2-0-260128 (стандартная), doubao-seedance-2-0-fast-260128 (быстрая) и doubao-seedance-2-0-mini-260615 (мини/лайт) — новейшее семейство моделей генерации видео от ByteDance: четыре модели, работающие параллельно и предоставляемые через APIYI на официальных ресурсах Volcengine в материковом Китае (не международная версия BytePlus), со встроенной upstream-проверкой безопасности контента. Они поддерживают преобразование текста в видео, преобразование первого+последнего/первого кадра в видео и преобразование мультимодальных референсов в видео, а также могут генерировать голос, звуковые эффекты и фоновую музыку, синхронизированные с визуальным рядом. 2.5 — наиболее производительный уровень: максимальная длительность увеличена с 15 до 30 секунд, количество референсных изображений — с 9 до 30, аудио может использоваться как самостоятельный референс, а также добавлены вывод в формате mov и явные типы задач редактирования/продления видео. Она также стоит дороже — примерно в 1,5 раза больше, чем стандартная модель 2.0 (около $1.35 против $0.91 за 720p/5 с), что соответствует разнице между двумя поколениями в собственных прайс-листах Volcengine. Семейство 2.0 остаётся доступным и не выводится из эксплуатации: для обычных клипов до 15 секунд стандартная модель дешевле и также поддерживает 1080p; mini — выбор для массового производства (примерно вдвое дешевле стандартной модели за единицу и генерирует быстрее, с ограничением до 720p), а fast занимает промежуточное положение. 2.5 работает в той же группе SeeDance2, что и семейство 2.0 (0.18x) — один token обеспечивает доступ ко всем четырём моделям. См. «Настройка группы» ниже.
🎬 Основные возможности: 2.5 поддерживает 4–30 с, семейство 2.0 — 4–15 с (оба принимают -1 для выбора длительности моделью); три уровня разрешения (480p/720p/1080p, при этом 1080p доступно только для 2.5 и стандартной 2.0); 6 соотношений сторон плюс адаптивное; синхронизированное аудио включено по умолчанию; многоязычные промпты. Создано для масштабного производства коротких видео, материалов для электронной коммерции, моушн-дизайна и контента с виртуальными персонажами.
🔥 Ограниченная по времени скидка — до 2026-10-07 23:59 (UTC+8): две новые группы для отдельных моделей, SD2Mini (0.10x) и SD2Fast (0.15x), снижают тариф на 44.4% для mini и на 16.7% для fast. Просто используйте один новый Token — изменения кода не требуются. См. «Группы с ограниченной по времени скидкой» и «Настройка группы» ниже.
Для вызова 2.5 токенам требуется группа SeeDance2 (коэффициент тарифа 0.18x) — та же группа, что и для семейства 2.0. Вызов doubao-seedance-2-5-260628 токеном из группы Default или другой видеогруппы завершится ошибкой «no available channel for this model».Один Token с включённым SeeDance2 обеспечивает доступ ко всем четырём моделям — 2.5 и семейство 2.0 используют одну группу и один тариф, поэтому в вашем коде меняется только поле model.

Справочник API генерации видео

POST /seedance/api/v3/contents/generations/tasks — эндпоинт асинхронных задач с интерактивной Playground и полным кодом для опроса/скачивания.

Руководство по API

Создание токенов, базовый URL, модели тарификации и общие правила вызовов.

Визуальное тестирование API

Отлаживайте этот эндпоинт непосредственно в инструменте визуального тестирования iCover — код не требуется.

Поиск / скачивание асинхронных задач

Просматривайте отправленные задачи генерации видео и скачивайте ссылки на видео в консоли APIYI — запись поиска вне API.

​
Позвольте AI-агенту выполнить интеграцию

Если вы разрабатываете с помощью Codex / Claude Code / Cursor, скопируйте приведённый ниже промпт и передайте его своему агенту. Сначала он получает текстовую версию этой страницы (добавьте .md к любому URL документации), а затем пишет код в используемом в вашем проекте стеке — асинхронный опрос, 24-часовое истечение срока действия ссылки, требующее немедленного копирования, ловушка с заголовком gzip и критические ограничения параметров уже включены в требования.

Поручите агенту, работающему с кодом, интегрировать или устранить неполадки генерации видео Seedance 2.5 / 2.0. Скопируйте этот текст и вставьте его в Codex, Claude Code, Cursor или аналогичные инструменты.

​
Почему Seedance от APIYI?

Сначала уточним позиционирование: эта модель не имеет официальной скидки, и APIYI не устанавливает на неё цену с целью получения прибыли — она предлагается, чтобы обеспечить доступность ресурсов и обслуживать клиентов. Реальная ценность использования APIYI заключается не в «дешевизне», а в доступе и удобстве работы:

Официальный ресурс · Материковая версия

Официальные ресурсы Volcengine для материкового Китая (а не международная версия BytePlus) со встроенной проверкой безопасности контента на стороне upstream. Параметры, ответы и тарификация полностью соответствуют официальному API.

Доступ к белому списку виртуальных лиц

Канал предоставляет доступ к белому списку виртуальных лиц на стороне upstream: лица, созданные ИИ, и виртуальные аватары можно напрямую использовать для преобразования изображения в видео; отдельная заявка на включение в белый список официального канала не требуется (лица реальных людей по-прежнему ограничены проверкой безопасности контента на стороне upstream).

Библиотека ресурсов включена бесплатно

Приватная библиотека ресурсов, лежащая в основе видео с сохранением идентичности персонажа (загрузка виртуального аватара + проверка реального человека), бесплатна в APIYI. В официальном сервисе это отдельно приобретаемое дополнение — годовой контракт стоимостью в несколько сотен тысяч юаней для клиентов без рамочного соглашения. Мы включаем его в стоимость API.

Цены с приоритетом доступности ресурсов · На уровне официальных

Официальной скидки не существует, и APIYI не получает прибыль от этой модели: цены за единицу соответствуют официальному прайс-листу Volcengine (тарификация на платформе примерно на 10% выше); с учётом бонусов за пополнение фактическая стоимость примерно соответствует стоимости официального канала, а клиенты с крупными пополнениями могут получить цену ниже официальной на некоторых уровнях.

Неограниченные параллельные запросы · Без очередей

В наших тестах все 15 одновременных задач сразу поступили в running без ожидания в очереди (измерено 2026-06-06 (UTC+8)) — сервис готов к масштабному пакетному производству.

Доступ без лишних препятствий · Без проверки личности

Не требуется аккаунт Volcengine, проверка настоящего имени или личности, а также достижение минимального порога расходов (не нужно вносить активационный депозит в размере 200 юаней и проходить проверку предприятия). Центры обработки данных материкового Китая, домашние сети и зарубежные узлы могут напрямую обращаться к api.apiyi.com с помощью одного Token.

Полная линейка видеомоделей

VEO 3.1 и Wan2.7 доступны на одной платформе — комбинируйте их в зависимости от задачи.

Профессиональная поддержка

Команда с опытом работы с задачами генерации видео предоставляет поддержку в выборе моделей, настройке и интеграции — от PoC до производственной эксплуатации.

​
Ключевые возможности

Три уровня · Одинаковая цена внутри уровня

480p / 720p / 1080p (1080p только для standard 2.5 и 2.0; для fast и mini максимум — 720p). Внутри уровня 16:9, 9:16, 1:1 и любое другое соотношение сторон имеют одинаковую площадь в пикселях и одинаковую цену — переключайтесь между альбомной и портретной ориентацией без доплаты.

Синхронизированный звук по умолчанию

generate_audio по умолчанию имеет значение true: голос, звуковые эффекты и фоновая музыка генерируются в соответствии с визуальным рядом. Заключайте произносимые реплики в двойные кавычки, чтобы повысить качество озвучивания.

Управляемая длительность до 30 с

2.5 принимает целые секунды от 4 до 30, семейство 2.0 — от 4 до 15; -1 позволяет модели выбрать длительность (тарификация по фактическому результату). В 2.5 значение duration по умолчанию — -1 — не указывайте его, и модель выберет за вас. Фиксированные 24 fps.

Многоязычные промпты

Китайский (до ~500 символов) и английский (до ~1000 слов), а также японский, испанский, португальский и индонезийский.

Первый+последний / первый кадр

Закрепите первый и последний кадры с помощью двух изображений или анимируйте одно изображение как первый кадр. Используйте вместе с return_last_frame, чтобы объединять клипы в более длинные непрерывные видео.

Мультимодальная генерация видео по референсам

2.5 принимает до 30 изображений + 10 видео + 10 аудио, при этом аудио можно использовать отдельно; семейство 2.0 принимает 9 изображений + 3 видео + 3 аудио, при этом для аудио требуется сопутствующее изображение или видео. Создавайте, редактируйте или расширяйте видео, сохраняя согласованность персонажей и стиля.

Асинхронный поток задач

Отправьте запрос и получите task_id, опрашивайте статус, затем скачайте mp4 из content.video_url (ссылка действует 24 часа).

Воспроизводимые seeds

Зафиксируйте seed для похожих результатов между запусками. Значение watermark по умолчанию — false — результат не содержит водяного знака.

​
Тарификация

Тарификация в одной строке — точный расчёт по token, уровень за уровнем привязанный к официальному сайту Volcengine. Для четырёх моделей действуют разные цены: mini < fast < standard < 2.5 (в том же порядке, что и на официальном сайте; mini работает примерно по половине удельной цены стандартной модели, а 2.5 — примерно по цене в 1,5 раза выше неё — это НЕ один и тот же ценовой уровень). Volcengine не предоставляет скидок на эту серию, а данный канал тарифицируется с учётом обеспечения поставок, поэтому номинальная ставка немного выше официальной; с учётом бонуса за пополнение (10% для обычных клиентов и до 20% для клиентов с крупным пополнением) фактическая стоимость по сути сопоставима с официальным сайтом — клиенты с крупным пополнением платят всего примерно на 5% больше, а на некоторых уровнях (например, цена 1080p для крупных клиентов) даже меньше. Расчёт ведётся по площади×длительности, поэтому отклонение в пределах ±5% является нормальным — вы можете протестировать, сверить расчёты и обратиться к нам в любое время.Ещё один момент: библиотека ресурсов, необходимая для согласованности персонажей в видео, бесплатно включена в APIYI (на официальном сайте это отдельная платная опция — годовой контракт стоимостью в сотни тысяч CNY для клиентов без рамочного соглашения). Эта ценность не отражена в приведённом выше сравнении удельных цен.
Тарификация по token: tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024 (длительность входного видео равна 0 для преобразования текста/изображения в видео; по результатам наших тестов подтверждено с точностью до 0,1%). Поскольку каждый коэффициент внутри уровня имеет одинаковую площадь в пикселях, цена зависит только от уровня разрешения, длительности выходного видео и наличия видео во входных данных.

​
Официальные ценовые ориентиры (выход 16:9 / 5 с, CNY за видео)

① Без входного видео (text-to-video / image-to-video / эталонные изображения): ② С входным видео (мультимодальный эталон, включая video_url; входное видео 2–15 с, нижний диапазон ≈ 2–4 с входных данных, верхний диапазон ≈ 15 с входных данных):
При наличии входного видео оплачиваемая длительность = длительность входного видео + длительность выходного видео, поэтому такой вариант стоит дороже обычного text-to-video / image-to-video; также применяется минимальный порог по token (очень короткие входные данные тарифицируются по этому порогу). Авторитетным значением использования является возвращённый usage.completion_tokens.
Сравнение по измерениям на платформе (тестирование проведено в 2026-06 и 2026-07, 16:9 / аудио по умолчанию / без входного видео; CNY по фиксированному курсу 1:7, только для справки):
Три модели имеют НЕ одинаковую стоимость — никогда не считайте их равноценными. При одинаковых разрешении и длительности цена за token возрастает в порядке mini < fast < standard (например, для 720p/5 с: mini ≈ ¥3.16, fast ≈ ¥5.08, standard ≈ ¥6.35), что соответствует официальной ценовой шкале. Для пакетного производства Mini экономит больше всего денег и времени (в ходе наших тестов в 2026-07 его фактическая цена за единицу точно соответствовала номинальному тарифу платформы; отклонение составило 0,00%); разрешение 1080p доступно только для стандартной модели.
Примечание: «CNY» — это списание по прайс-листу платформы; «Для общего тарифа ÷1.1» и «Для крупных клиентов ÷1.2» — эффективные цены после бонуса за пополнение на 10% / 20%; после начисления бонуса цены близки к официальному ориентиру, а цена 1080p для крупных клиентов даже ниже официальной. Авторитетным значением использования является возвращённый usage.completion_tokens.

​
Тарификация Seedance 2.5 (SeeDance2 группа, 0.18x)

Версия 2.5 и семейство 2.0 используют одну и ту же SeeDance2 группу и одну и ту же ставку 0.18x — разница между поколениями полностью обусловлена собственными ценами моделей за единицу. 720p/5s стоит $1.3721 в версии 2.5 против $0.9074 у стандартной модели 2.0, то есть примерно в 1.5 раза дороже. Эта разница соответствует собственным прайс-листам Volcengine (их ставка за token для версии 2.5 примерно на 52% выше, чем для 2.0); это не наценка APIYI. Оправданность перехода зависит от того, нужны ли вам ролики длительностью 30 секунд, 30 референсных изображений, вывод в формате mov или редактирование/продление видео — если нет, стандартная модель 2.0 дешевле и также поддерживает 1080p. ① Без видео во входных данных (текст-в-видео, изображение-в-видео, референсные изображения): ② Видео во входных данных (мультимодальный референс с video_url, редактирование видео, продление видео): тарифицируется по отдельной, более низкой ставке за token. Более низкая ставка не означает меньшую итоговую сумму: при наличии видео во входных данных тарифицируемые tokens = (длительность входного видео + длительность вывода) × площадь, поэтому само количество tokens увеличивается. Строка выше стоила бы $1.0945 по ставке ①; по ставке ② она стоит $0.6567. Две ставки за tokens: И количество tokens, и обе ставки взяты из фактических журналов тарификации (повторно проверено 2026-08-31), а не рассчитаны по формуле. После применения бонуса за пополнение клиенты с пополнением на высоком уровне получают цену, близкую к официальной справочной.
Два самых простых способа переплатить за 2.5:
  1. duration по умолчанию принимает значение -1 (для семейства 2.0 по умолчанию используется значение 5). Если не указать этот параметр, 2.5 самостоятельно выберет длительность от 4 до 30 секунд — тестовый запрос без указания длительности вернул 10-секундный ролик, что ровно вдвое дороже 5 секунд. Явно передавайте duration, если стоимость имеет значение.
  2. 30 секунд стоят в 6 раз дороже 5 секунд (¥57.23 против ¥9.60 при 720p). Стоимость строго пропорциональна длительности, поэтому проверяйте промпт на 5 секундах, прежде чем переходить к длинным роликам.
Приведённые выше таблицы и таблица для 2.0 выше относятся к одной и той же SeeDance2 группе со ставкой 0.18x, поэтому их можно напрямую сравнивать. fast и mini также имеют группы со скидкой на ограниченный срок и более низкими ценами — см. следующий раздел.
Примечания по тарификации:
  • Итоговые списания соответствуют ценам моделей в консоли и журналам вызовов
  • Задачи предварительно оплачиваются при отправке и окончательно рассчитываются после завершения — ваш баланс ненадолго изменяется; сверяйте данные с журналами вызовов, где для одного видео создаются две записи о списании (см. раздел «Чтение списаний в журналах» ниже)
  • Резервируемая сумма зависит только от длительности и не зависит от разрешения: $0.09/секунду для семейства 2.0 и $0.135/секунду для 2.5. Поэтому для 1080p обычно выполняется дополнительное списание, а для 480p обычно возвращается часть средств — это нормальное поведение
  • Отклонённые запросы (ошибки параметров HTTP 400 и т. п.) не тарифицируются (проверено)
  • Стоимость линейно зависит от длительности: видео длительностью 15 s стоит примерно в 3 раза дороже видео длительностью 5 s

​
Группы с ограниченной по времени скидкой (только mini / fast, до 10/7)

8 августа 2026 года запущены две группы с ограниченной по времени скидкой: SD2Mini (коэффициент 0.10x) и SD2Fast (коэффициент 0.15x). По сравнению с обычной группой SeeDance2 с коэффициентом 0.18x это скидка 44.4% для mini и 16.7% для fast. Возможности моделей, параметры, эндпоинты и синтаксис вызова не изменились — замените один Token и не меняйте код. Предложение действует до 2026-10-07 23:59 (UTC+8) (продлено 2026-09-05 одновременно с официальной акцией Volcengine; первоначальной датой окончания было 7 сентября).
Сопоставимое сравнение цен (рассчитано на основе указанных выше измеренных значений пропорционально коэффициенту новой группы, то есть делением на 0.18 и умножением на новый коэффициент; CNY конвертированы по фиксированному курсу 1:7, только для справки): Та же модель, те же характеристики: группы со скидкой позволяют сэкономить 44.4% на mini и 16.7% на fast. Это прямое снижение коэффициента группы, которое независимо суммируется с бонусом за пополнение. Тарификация не изменилась — расчёт по-прежнему выполняется по фактическому использованию token, при этом отклонение ±5% является нормальным.
После окончания предложения ничего не отключается: после 2026-10-07 23:59 (UTC+8) SD2Mini и SD2Fast останутся доступными — их коэффициент просто вернётся к 0.18x, как у обычной группы SeeDance2. Ваши Tokens продолжат работать, и изменения кода не потребуются. Если вы планируете пакетное производство, запланируйте его в период действия скидки.

​
Просмотр списаний в логах (предварительное списание + окончательный расчёт)

Откройте страницу логов консоли по адресу api.apiyi.com/log и найдите название модели doubao-seedance-2-0, чтобы увидеть все списания. Одно видео создаёт две записи о списании:
  1. Предварительное списание: расчётная сумма, удерживаемая при отправке задачи (запись в логе с пометкой «non-streaming», содержащая token и группу) — $0.449998 на снимке экрана ниже
  2. Окончательный расчёт (списание или возврат): после завершения задачи разница рассчитывается на основе фактически сгенерированных token (запись в логе с пометкой «streaming» и количеством completion-token) — ниже указано $5.611858; для 1080p обычно взимается дополнительная плата
Страница логов APIYI с двумя записями о списании за одно видео Seedance 2.0: предварительное списание и окончательный расчёт

Two charge entries for one 15 s 1080p video: pre-charge + settlement

В записи об окончательном расчёте нет ни token, ни его группы — это нормально. Сумма двух записей составляет общую стоимость видео.
Как читать поля времени:
  1. Временная метка первой записи (предварительного списания) — это время отправки видео; значение «first byte» показывает, сколько времени заняла отправка до получения ID задачи (например, 首字节:3秒 / first byte: 3 с), — а не время генерации
  2. В записи об окончательном расчёте указаны 流式 (streaming) и 首字节:<1秒 (first byte менее 1 с) — это всего лишь внутренние маркеры записи об окончательном расчёте, а не признак какой-либо проблемы
  3. Фактическое время генерации видео указано в столбце «耗时» (истекшее время) на странице «Асинхронные задачи» (api.apiyi.com/task) в верхней навигации
Просмотр полей времени и first byte на странице логов: первая запись содержит время отправки и задержку отправки

The first log entry's timestamp = submission time, and its first-byte value (3 s) is the submission latency; this fast example settled as a refund (negative amount), total cost 0.360000 − 0.022750 = 0.337250 USD

Страница «Асинхронные задачи», на которой для каждой задачи видео указаны время отправки и истекшее время генерации

The elapsed column on the Async tasks page is the actual video generation time, e.g. 158 s, 303 s

Для видео длительностью 15 с в разрешении 1080p на первом снимке экрана общая стоимость = 0.449998 + 5.611858 = $6.061856. Соответствующие параметры задачи отображаются в разделе «Асинхронные задачи» в верхней части api.apiyi.com/task и полностью совпадают со списаниями:
732 108 completion-token ≈ 15 × 1248 × 1664 × 24 / 1024 (видео 3:4 в разрешении 1080p создаётся с размером 1248×1664) — это соответствует формуле тарификации.
Это видео длительностью 15 с в разрешении 1080p стоит в общей сложности около ¥42.4 (номинальная плата при фиксированном курсе 1:7); с учётом бонуса за пополнение фактическая стоимость составляет примерно ¥35–39 по сравнению с официальной ориентировочной ценой около ¥37.2 за те же характеристики. Сама официальная цена невысокой не является — стоимость определяется сочетанием модели + разрешения + длительности (переключение на fast / 720p / 5 с обходится значительно дешевле). Эта модель предоставляется с небольшой маржой для обеспечения доступности, а клиенты с крупными депозитами получают большие скидки.
Уведомление о бета-поставке: Seedance 2.5 и семейство 2.0 в настоящее время находятся на этапе бета-поставки. Если ваши фактические списания заметно отличаются от приведённой выше таблицы, обратитесь в службу поддержки, и мы выполним сверку. Тарификация будет динамически корректироваться в соответствии с политикой вышестоящего поставщика (например, если позднее появится официальный вариант с более низкой ценой) и возможностями поставок APIYI; надёжные партнёры каналов продаж могут связаться с нами. Эта модель тарифицируется для обеспечения поставок и обслуживания клиентов, а не для получения прибыли.

​
Настройка групп

Seedance 2.5 и семейство 2.0 работают в выделенной группе, при соблюдении двух обязательных условий: ① модель тарификации Token должна быть Pay-as-you-go Priority (или Pay-as-you-go) — Tokens с оплатой за запрос не могут быть направлены; ② для Token должна быть включена соответствующая группа. Tokens в группе Default или других группах видео завершатся ошибкой “no available channel for this model”. Сейчас доступно три группы. 2.5 и семейство 2.0 используют общую SeeDance2, а также есть две группы с ограниченной по времени скидкой, каждая из которых обслуживает ровно одну модель:
Один Token SeeDance2 открывает доступ ко всем четырём моделям: 2.5 и три модели семейства 2.0 находятся в этой группе, поэтому в вашем коде меняется только поле model.Две скидочные группы являются каналами для одной модели: SD2Mini обслуживает только mini, а SD2Fast — только fast, поэтому вызов любой другой модели через них вернёт ту же ошибку.После окончания акции отключения не будет: после 2026-10-07 23:59 (UTC+8) обе скидочные группы останутся онлайн, а коэффициент тарифа вернётся к 0.18x — изменения Token или кода не требуются.
Для 2.5 используется тот же коэффициент 0.18x. Разница между поколениями обусловлена собственными ценами моделей за единицу (цены Volcengine для 2.5 выше, чем для 2.0), а не коэффициентом группы — поэтому 2.5 и семейство 2.0 работают по совершенно одинаковой базе конвертации.Почему 0.18x? Встроенные в систему цены за единицу для Seedance соответствуют официальным прайс-листам Volcengine — но этот прайс-лист указан в CNY, тогда как балансы APIYI указаны в USD (фиксированный курс USD/CNY 1:7). При коэффициенте 1x фактически взималось бы в 7 раз больше официальной суммы, поэтому коэффициент группы снижен для компенсации конвертации валюты — именно отсюда берётся 0.18: это не скидка и не наценка.Volcengine не предоставляет скидок на эту серию, а цена этого канала установлена для обеспечения поставок. По умолчанию номинальное списание немного выше официальной ориентировочной цены, но бонус пополнения в значительной мере это компенсирует: клиенты с крупными пополнениями платят всего примерно на 5% больше, а некоторые уровни (например, 1080p) оказываются ниже официальной цены.Обратите внимание: тарификация всегда основана на фактическом использовании token, а конвертация token имеет небольшое естественное отклонение (±5% — это нормально); официальный прайс-лист является лишь ориентиром, а не гарантией для каждого запроса. Текущая цена — это разумная схема с приоритетом обеспечения поставок, поэтому всегда оценивайте её вместе с бонусом пополнения. Если списание выглядит некорректным, мы в любое время готовы сверить с вами начисления; однако вопрос «почему цена немного выше официальной» не подлежит обсуждению — пожалуйста, учитывайте это и не используйте данный канал, если это вызывает сомнения. В свою очередь, именно этот канал обеспечивает высокую параллельность без очередей.Кроме того, библиотека ассетов (загрузка виртуальных аватаров / верификация реальных людей) бесплатно включена в этот канал — официально для её отдельной покупки требуется годовой контракт на шестизначную сумму в CNY. Это является частью реальной ценности данного канала.

​
Как настроить ваши Tokens

Если вам не нужны скидки: создайте один Token с включённой группой SeeDance2 — он обеспечивает доступ ко всем четырём моделям — и пропустите таблицу ниже. Если вам нужны ограниченные по времени скидки: у mini и fast есть собственные группы для одной модели, поэтому разделите Tokens следующим образом: Каждый Token должен использовать модель тарификации Pay-as-you-go Priority (или Pay-as-you-go). Если вы используете только mini, достаточно одного Token A; если только 2.5 — достаточно одного Token C — все они вам не нужны.
Почему отдельный скидочный Token оправдан:
  • Вы не пропустите срок — тарификация разделена по Token, поэтому сразу видно, что вы использовали и сколько сэкономили во время акции, а также легче решить, стоит ли перенести пакетные задачи на более ранний срок по мере приближения 7 октября
  • Переключение ничего не стоит — когда акция закончится, направьте клиент обратно на Token C; изменения кода или групп не нужны
  • Выделенные Tokens в любом случае рекомендуются для production — контроль квот и оповещения для каждой бизнес-линии, а также значительно более простое отслеживание неожиданного скачка потребления
Seedance 2.5 уже доступен (2026-08-28): имя модели — doubao-seedance-2-5-260628, она находится в той же группе SeeDance2 (0.18x), что и семейство 2.0. Эндпоинт, аутентификация и формат запросов идентичны 2.0 — замените поле model, и ваш код продолжит работать. По сравнению с семейством 2.0: ограничение длительности 15 с → 30 с, референсные изображения 9 → 30, референсные видео/аудио 3 → 10, аудио можно использовать отдельно, а также доступны вывод mov и селектор задач omni_reference_task_type. Модель работает примерно в 1.5× быстрее стандартной модели 2.0. Полное сравнение смотрите ниже в разделе «Технические характеристики».

​
Технические характеристики

​
Эндпоинты API

Домены: api.apiyi.com является основным шлюзом; vip.apiyi.com и другие домены платформы работают идентично. Префикс пути — /seedance/api/v3 — не удаляйте сегмент /api, и не используйте /v1/videos.

​
Разрешения и соотношения сторон в деталях

Уровень разрешения определяет площадь в пикселях, а не короткую сторону. Фактические размеры вывода для каждого соотношения (официальные значения, проверенные в наших тестах):
В 2.5 разрешение 480p с соотношением 16:9 составляет 854×480 (измерено), а не 864×496, которое выдаёт 2.0, — площадь немного меньше, поэтому одна и та же спецификация стоит немного меньше token. Все остальные измеренные нами уровни совпадают в обоих поколениях: 480p 1:1 = 640×640, 720p 16:9 = 1280×720, 720p 21:9 = 1470×630, 1080p 16:9 = 1920×1080.Ни одна модель этого семейства не поддерживает 4k — отправка "resolution": "4k" возвращает синхронную ошибку 400 (не тарифицируется).

​
Как работает адаптивный режим

  1. Текст-видео: модель определяет оптимальное соотношение на основе вашего prompt
  2. Первый+последний / первый кадр: используется соотношение изображения первого кадра (изображения с несовпадающим соотношением обрезаются по центру)
  3. Мультимодальное преобразование по референсу в видео: учитывается намерение, заданное в prompt; в противном случае используется первый медиаэлемент (видео имеет приоритет над изображениями)
  4. Редактирование / расширение видео (2.5): соотношение вывода соответствует входному видео, которое редактируется или расширяется
  5. Фактически использованное соотношение возвращается в поле ratio ответа задачи
ratio принимает только 7 указанных выше значений перечисления — передача, например, "2:1" возвращает ошибку InvalidParameter (проверено); то же происходит при передаче duration за пределами поддерживаемого диапазона (4–30 в 2.5, 4–15 в семействе 2.0). Ни один из этих вариантов не тарифицируется.В 2.5 дополнительно требуется ratio: adaptive для трёх типов задач: генерация по первому кадру / по первому и последнему кадрам, редактирование видео и расширение видео. Передача конкретного соотношения сторон в этих случаях возвращает InvalidParameter.TaskTypeConstraint на этапе отправки (измерено: синхронная ошибка 400, а не задача, завершающаяся ошибкой через несколько минут).

​
Лучшие практики

1

Выбирайте модель в соответствии с требованиями к результату

Сначала выясните, нужно ли вам то, что есть только в 2.5: ролики длительностью 30 секунд, 30 эталонных изображений, отдельные эталонные аудиозаписи, вывод в формате mov или явные типы задач редактирования/продления видео. Если нужно что-либо из этого, выберите doubao-seedance-2-5-260628 (примерно в 1,5 раза дороже стандартной модели, в той же группе, что и семейство 2.0). Если нет, используйте семейство 2.0: для пакетного производства и задач, чувствительных к стоимости, используйте lite-модель doubao-seedance-2-0-mini-260615 (примерно вдвое дешевле стандартной модели и обеспечивает самую быструю генерацию, с ограничением до 720p); для 1080p или максимального качества используйте стандартную модель; fast — промежуточный вариант.
2

Сначала загружайте изображения и видео, чтобы получить ID актива

Когда запрос содержит медиафайлы, задержка создания задачи в основном определяется загрузкой этих медиафайлов: встроенный Base64 или URL большого изображения увеличивает время отправки примерно с одной секунды до десятков секунд либо приводит к тайм-ауту чтения. Сначала загрузите медиафайл, получите ID актива asset:// и укажите его в запросе — размер тела запроса сократится до нескольких десятков байт, ID задачи вернётся немедленно, а проверки содержимого будут выполнены на этапе загрузки. См. Рабочий процесс с предварительной загрузкой актива.
3

Используйте adaptive, чтобы избежать обрезки

Для преобразования изображения в видео сохраняйте значение по умолчанию adaptive, чтобы модель сопоставляла соотношение сторон исходного изображения. Фиксируйте 9:16 (книжная ориентация) или 16:9 (альбомная ориентация) только при наличии соответствующего требования целевой платформы.
4

Длительность — ваш регулятор стоимости

Стоимость строго пропорциональна длительности. Сначала проверяйте промпты на роликах длительностью 5 с, затем увеличивайте длительность (2.5 поддерживает ролики до 30 с, что в 6 раз дороже ролика длительностью 5 с). В 2.5 всегда явно передавайте duration — значение по умолчанию равно -1, поэтому при его отсутствии модель выбирает значение самостоятельно, а при тестировании выбиралось 10 секунд, что удваивало стоимость.
5

Отключайте аудио, если оно вам не нужно

generate_audio по умолчанию имеет значение true. Передавайте false для видео без звука, которое вы планируете озвучить самостоятельно.
6

Заключайте реплики в кавычки для улучшения закадрового голоса

Помещайте произносимые реплики в двойные кавычки в промпте — модель автоматически сгенерирует соответствующие голоса.
7

Добавляйте Accept-Encoding: identity в HTTP-клиенты

Шлюз помечает ответы как content-encoding: gzip, хотя тело ответа не сжато; клиенты с автоматической распаковкой, например Python requests, вызывают ContentDecodingError. Добавление заголовка Accept-Encoding: identity устраняет эту проблему (curl это не затрагивает).
8

Проверяйте статус каждые 15–30 с и сразу скачивайте результат

Задачи обычно выполняются за 2–5 минут. content.video_url — это подписанная ссылка, действительная в течение 24 часов; после успешного выполнения задачи сразу скопируйте файл в собственное хранилище.
9

Объединяйте ролики с помощью return_last_frame

Установите return_last_frame: true, чтобы получить PNG последнего кадра без водяного знака, а затем используйте его в качестве первого кадра следующей задачи для создания непрерывных видео из нескольких роликов.

​
Коды ошибок и повторные попытки

Рекомендации для клиента:
  • Таймаутов запросов продолжительностью 30–60 с достаточно для вызовов создания/опроса (ожидание происходит на стороне задачи)
  • Выполняйте опрос каждые 15–30 с с общим лимитом времени 15+ минут (больше для задач 1080p / 15 с)
  • Применяйте экспоненциальную задержку при ошибках 5xx и таймаутах (2 повтора)
  • Для устранения неполадок записывайте id задачи и заголовок ответа x-request-id

​
Часто задаваемые вопросы

Медленной является отправка, а не генерация. Медиафайл должен пройти через APIYI, затем быть перенаправлен в Volcengine, где он декодируется и проверяется, — идентификатор задачи возвращается только после завершения всех этих операций. При использовании встроенного Base64 или URL большого изображения этот этап занимает не около секунды, а десятки секунд, и даже тайм-аут чтения клиента в 60 секунд может оказаться недостаточным. Сама генерация обычно занимает 2–5 минут — это нормальная скорость провайдера, не связанная со скоростью отправки.Реальное решение — сначала загрузить медиафайл и передать на него ссылку как на asset:// идентификатор ресурса, что уменьшает тело запроса с мегабайт до нескольких десятков байт. Разбор задержек, шаги миграции и способ проверить, была ли задача создана после тайм-аута, описаны в разделе Рабочий процесс сначала с ресурсами.
Выбирайте с учётом необходимых возможностей — 2.5 не является автоматическим вариантом по умолчанию. Она работает примерно в 1,5 раза дороже стандартной модели 2.0 (720p/5 с: $1.3721 против $0.9074), что соответствует разнице в собственных прейскурантных ценах Volcengine.Выбирайте 2.5, если нужны ролики длиннее 15 секунд (2.5 поддерживает до 30 секунд), более 9 эталонных изображений (2.5 принимает 30), формат вывода mov или редактирование / расширение видео с выявлением ошибок параметров уже на этапе отправки (omni_reference_task_type). 2.5 также позволяет использовать аудио как единственный эталон, тогда как 2.0 требует изображения или видео в дополнение к нему.Оставайтесь в семействе 2.0, если ваши ролики короче 15 секунд: стандартная модель также поддерживает 1080p и относится к тому же флагманскому уровню качества; для пакетного производства с учётом стоимости используйте mini — его цена за единицу примерно вдвое ниже стандартной, а генерация выполняется быстрее всего. Семейство 2.0 не выводится из эксплуатации.Эндпоинт, авторизация и структура запроса идентичны для всех поколений, как и группа — для переключения достаточно изменить одно поле: model.
1080p работает (проверено: видео 1920×1080 создаётся без проблем). 4k не поддерживается — отправка "resolution": "4k" возвращает синхронную ошибку 400 (тарификация не выполняется).Есть одно важное отличие, которое легко пропустить: 2.5 кодирует 1080p в H.265 (hvc1), тогда как для 480p и 720p используется H.264 (avc1). Файлы H.265 меньше, но старые проигрыватели, некоторые браузеры и отдельные пакеты для монтажа работают с ним менее надёжно, чем с H.264. Перед распространением видео 1080p убедитесь, что ваш последующий конвейер может его декодировать.
Оба режима представляют собой задачи с «омни-эталоном»: они запускаются эталонным видео в content и намерением, выраженным в промпте. Явно передавайте omni_reference_task_type, чтобы ошибки выявлялись на раннем этапе:
  • Редактирование видео: omni_reference_task_type: "edit", как минимум один role: "reference_video", ratio должен иметь значение adaptive, а duration — значение -1, исходное видео должно длиться 4–30 секунд. В промпте должен быть глагол редактирования (добавить, удалить, изменить, заменить). Соотношение сторон и длительность вывода соответствуют входному видео, причём длительность может быть дробной (в одном проверенном запуске результат длился 16,709 секунды).
  • Расширение видео: omni_reference_task_type: "extend", также с эталонным видео и ratio, установленным в adaptive. В промпте должен быть глагол расширения (продолжить, продлить).
Ссылайтесь на ресурсы в промпте по их позициям — @video1, @image1 — в том порядке, в котором они были переданы. Недопустимые параметры возвращают ошибку 400 при отправке (InvalidParameter.TaskTypeConstraint), а не приводят к сбою задачи через несколько минут.
Передача "output_format": "mov" возвращает контейнер QuickTime (H.264 + цветовая субдискретизация yuv444p + аудио PCM) с более высокой точностью передачи цвета и яркости — он подходит для цветокоррекции, кейинга и композитинга и официально рекомендован как для входных, так и для выходных данных при редактировании и расширении видео. По умолчанию используется mp4, обеспечивающий наиболее широкую совместимость.Учтите, что mov использует профессиональные кодеки, которые поддерживаются не всеми проигрывателями (с ними работают VLC, mpv, ffplay и IINA в macOS). Для прямого распространения в интернете или на мобильных устройствах используйте формат mp4 по умолчанию.
Это самая распространённая ошибка Seedance: в девяти случаях из десяти для токена включена неправильная группа. В сообщении об ошибке указывается текущая группа, например:
Сопоставьте модель с её группой и включите эту группу в настройках токена:Один ключ с включённой SeeDance2 обеспечивает доступ ко всем четырём моделям. Модель тарификации также должна быть Pay-as-you-go Priority или Pay-as-you-go — токены Pay-per-request не могут выполнять маршрутизацию.
Заголовок content-encoding: gzip шлюза не соответствует фактическому кодированию тела. Симптомы включают ContentDecodingError, усечённое тело, не являющееся JSON (например, начальный {" теряется, и вы получаете только id":"cgt-xxx"}), или периодические ошибки 400. Добавьте "Accept-Encoding": "identity" в заголовки запроса; curl и browser fetch не затронуты.
Для generate_audio по умолчанию используется true (проверено): модель автоматически добавляет речь, звуковые эффекты и фоновую музыку. Для вывода без звука явно передайте "generate_audio": false.
При успешном выполнении URL находится в content.video_url ответа на запрос проверки (не на верхнем уровне). Это подписанная ссылка, действительная около 24 часов, поэтому сразу скачайте видео и разместите его на своём хостинге. Саму задачу можно запрашивать по task_id в течение 7 дней.
Конечный автомат имеет состояния queued → running → succeeded / failed / expired. Состояние успешного выполнения — succeeded, а не completed. Это распространённая ошибка при миграции с других API для работы с видео.
Нет. Ни Seedance 2.5, ни семейство 2.0 не принимают эталонные изображения или видео с лицами реальных людей (ограничения безопасности контента на стороне провайдера). Возможные альтернативы: повторно использовать результат с лицом, созданный моделями Seedance за последние 30 дней; воспользоваться готовыми виртуальными аватарами платформы (идентификаторы asset://); или использовать лицензированные ресурсы с лицами.
Нет. Загрузка виртуальных аватаров, проверка личности реальных людей и остальные возможности приватной библиотеки ресурсов бесплатны при использовании API Seedance 2.0 на APIYI — без ежегодной платы. Официально эта возможность приобретается как отдельное дополнение: для клиентов без рамочного соглашения годовой контракт стоит шестизначную сумму в юанях CNY (Volcengine также продаёт её напрямую). Мы ценим долгосрочных пользователей, поэтому эта стоимость уже включена в цену нашего API; для клиентов, использующих SD2 API в обычных коммерческих объёмах, дополнительная плата не взимается. Инструкции по использованию приведены в разделе Библиотека ресурсов.
Отклонение параметров (HTTP 400) не тарифицируется (проверено). При отправке средства списываются предварительно, а окончательный расчёт выполняется после завершения, поэтому баланс кратковременно изменяется — сверяйте его с журналами вызовов.
tokens ≈ duration(s) × width × height × 24 / 1024, точность подтверждена в пределах 0,1%. Для каждого соотношения сторон в тарифном уровне используется одинаковая площадь изображения (720p 16:9 и 9:16 стоят по 108 900 token за 5 секунд) — альбомная, портретная и квадратная ориентации стоят одинаково.
Цена и скорость располагаются в порядке mini < fast < standard (номинальные значения на платформе для 720p/5 с: примерно ¥3.16 / ¥5.08 / ¥6.35). Выбирайте mini для пакетного производства и задач с ограниченным бюджетом — цена примерно вдвое ниже стандартной, а генерация выполняется быстрее всего (по измерениям за 2026-07: около 1,5–2,5 минуты для 5 с при 720p). Выбирайте standard для максимальной детализации, а fast — как промежуточный вариант. И mini, и fast ограничены разрешением 720p — запрос 1080p возвращает ошибку параметра 400 (тарификация не выполняется).Если вам достаточно 1080p, стандартная модель 2.0 уже его поддерживает — обновляться только ради этого не нужно. Переходите на 2.5 для роликов длительностью 30 секунд, более 9 эталонных изображений, вывода в mov или редактирования и расширения видео (цена примерно в 1,5 раза выше стандартной модели, группа та же, что у семейства 2.0).
Модель самостоятельно выбирает длительность (4–30 с в 2.5, 4–15 с в семействе 2.0), а тарификация выполняется по фактической длительности результата. Итоговая длительность возвращается в поле duration задачи.Учтите, что -1 используется в 2.5 по умолчанию (в семействе 2.0 по умолчанию используется 5 секунд): если не указать duration, модель сама выберет длительность, и проверенный запрос 2.5 без указания длительности вернул ролик на 10 секунд — ровно вдвое дороже ролика на 5 секунд. Если важна предсказуемость стоимости, явно передавайте duration.
Нет. frames и camera_fixed — параметры Seedance 1.x, которые не поддерживаются ни Seedance 2.5, ни серией Seedance 2.0. Вместо них используйте duration с целым числом секунд.
Нет — это три взаимоисключающих режима: первый и последний кадры (2 изображения с обязательными ролями first_frame/last_frame), первый кадр (1 изображение) и мультимодальное преобразование эталона в видео (роль изображения reference_image). Чтобы приблизить сценарий «первый/последний кадр + эталон», используйте режим эталона и укажите кадр в промпте.Ограничения на эталонные данные различаются по поколениям: 2.5 принимает 30 изображений + 10 видео + 10 аудиоклипов, причём аудио может использоваться отдельно; семейство 2.0 принимает 9 изображений + 3 видео + 3 аудиоклипа и требует как минимум 1 изображения или 1 видео в дополнение к любому аудио.
Группа SeeDance2 поддерживает большое количество параллельных запросов без постановки в очередь (в нашем тесте 15 одновременных задач запустились сразу). Для более крупных постоянных нагрузок обратитесь в отдел продаж.
Ограничивайте промпты примерно 500 китайскими иероглифами или 1000 английскими словами — более длинные промпты снижают детализацию. Поддерживаются следующие языки: китайский, английский, японский, испанский, португальский и индонезийский. Описывайте объект, действие, движение камеры и освещение или стиль.

​
Связанная документация

Seedance — одно из немногих первоклассных семейств видеомоделей 2026 года, которое по умолчанию генерирует синхронизированный звук. В сочетании с одинаковой стоимостью для разных соотношений сторон и ограничением в 30 секунд у версии 2.5 это надёжный основной канал для производства материалов для коротких видео и электронной коммерции. Для сравнения альтернатив тот же token (при включённых дополнительных группах) позволяет напрямую вызывать Sora 2, VEO 3.1 и Wan2.7.