Перейти к основному содержанию

​
Обзор

doubao-seedance-2-5-260628 (2.5), doubao-seedance-2-0-260128 (standard), doubao-seedance-2-0-fast-260128 (fast) и doubao-seedance-2-0-mini-260615 (mini/lite) — это новейшее семейство моделей генерации видео от ByteDance: четыре параллельно работающие модели, предоставляемые через APIYI на базе официальных ресурсов Volcengine в материковом Китае (не международная версия BytePlus) со встроенной модерацией контента на стороне апстрима. Они поддерживают преобразование текста в видео (text-to-video), первого/первого и последнего кадров в видео (image-to-video), а также генерацию видео по мультимодальным референсам (reference-to-video). Модели также способны генерировать голос, звуковые эффекты и фоновую музыку, синхронизированные с видеорядом. 2.5 — это наиболее функциональный уровень: лимит длительности увеличен с 15 до 30 секунд, количество референсных изображений — с 9 до 30, аудио может выступать в качестве самостоятельного референса, а также добавлена поддержка вывода в формате mov и явных типов задач редактирования и продления видео (video-edit/extend). Стоимость этой версии также выше — примерно в 1,5 раза дороже стандартной модели 2.0 (около $1.35 против $0.91 за 720p/5 с), что соответствует разнице между двумя поколениями в официальном прейскуранте Volcengine. Семейство 2.0 остается доступным и не выводится из эксплуатации: для стандартных роликов короче 15 секунд модель standard обходится дешевле и также поддерживает 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 standard); 6 соотношений сторон плюс адаптивное; синхронизированное аудио включено по умолчанию; многоязычные prompt. Создано для масштабного производства коротких видео, e-commerce-материалов, моушн-дизайна и контента с цифровыми аватарами.
Для вызова 2.5 токенам требуется группа SeeDance2 (коэффициент тарифа 0.18x) — та же группа, что и для семейства 2.0. Если token из группы Default или другой видеогруппы попытается вызвать doubao-seedance-2-5-260628, запрос завершится ошибкой «no available channel for this model».Один token с включенной группой SeeDance2 открывает доступ ко всем четырем моделям — 2.5 и семейство 2.0 используют одну и ту же группу и одинаковый тариф, поэтому в коде достаточно изменить только поле model.

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

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

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

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

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

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

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

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

​
Доверьте интеграцию AI-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

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

Выполните интеграцию / диагностику генерации видео Seedance 2.5 / 2.0 (text-to-video, первый/последний кадр, мультимодальный референс, редактирование видео, расширение видео) в этом проекте.

Перед тем как писать код, изучите документацию: загрузите https://docs.apiyi.com/en/api-capabilities/seedance2/overview.md для получения текстовой версии этой страницы. Подробности об эндпоинтах приведены на странице генерации видео …

  1. Используйте трехэтапный асинхронный процесс вместо синхронного ожидания. Отправьте запрос на POST /seedance/api/v3/contents/generations/tasks, чтобы получить ID задачи, опрашивайте …

Всего 9 требований. Используйте кнопку ниже, чтобы скопировать prompt полностью.

​
Почему 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 работает примерно по половине удельной цены standard, а 2.5 — примерно по цене в 1,5 раза выше неё — это НЕ один и тот же ценовой уровень). Volcengine не предоставляет скидок на эту серию, а данный канал работает как чистый официальный релей для гарантированного доступа к поставкам, а не ради прибыли. Цены рассчитываются относительно базового уровня «клиент с крупным депозитом и бонусом 20%»: номинальное списание составляет 1,26× официальной цены (коэффициент тарифа 0,18 × фиксированный курс обмена 1:7), что после применения бонуса за пополнение в размере 20% даёт примерно 1,05× официальной цены — эта надбавка в 5% в основном покрывает расходы на НДС в размере 6% при оформлении специальных счетов-фактур. Для обычных клиентов с бонусом 10% итог составляет примерно 1,15×. Тарификация выполняется по площади×длительности, поэтому отклонение в пределах ±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 с входного видео):
Каждая цена в таблице ② по-прежнему рассчитана для 5-секундного выхода; диапазон отражает только длительность входного видео (2–15 с) — CNY 30.13 означает «5 с выхода + 15 с входного видео», а не выход длительностью 15 секунд. При использовании входного видео тарифицируемая длительность = длительность входного видео + длительность выхода, причём обе части преобразуются в кадры с выходным разрешением; также применяется минимальный порог tokens (очень короткие входные видео тарифицируются по этому порогу). Авторитетным источником данных об использовании является возвращаемый usage.completion_tokens.Пример расчёта (стандартная модель, 1080p, выход 12 с + референсное видео 12 с): для 1080p используется 1920 × 1080 ÷ 1024 = 2025 tokens на кадр; выход: 24 × 12 + 1 = 289 кадров, плюс 288 входных кадров = 577 × 2025 = 1,168,425 tokens. При официальной ставке для входного видео около CNY 0.031 за 1K tokens это составляет примерно CNY 36.2; номинальная стоимость в APIYI — $6.52 (CNY 45.6), а для клиента с крупным пополнением после бонуса 20% — около CNY 38.0. Эта задача не соответствует ни одной ячейке таблицы ②, поскольку выход не равен 5 секундам.
Сравнение, измеренное на платформе (тестирование проведено в 2026-06 и 2026-07, формат 16:9 / аудио по умолчанию / без входного видео; CNY по фиксированному курсу 1:7, только для справки): Измерения на платформе (с входным видео) (тестирование проведено 2026-09-12, стандартная модель 1080p / 9:16 / без аудио / референсное видео 12 с; CNY по фиксированному курсу 1:7): Входное видео тарифицируется по отдельной, более низкой ставке tokens (в этом запуске 1080p измеренная стоимость составила $5.58 за миллион tokens против $8.28 для 1080p без видео), однако каждая секунда входного видео преобразуется в tokens с выходным разрешением и тарифицируется вместе с выходом, поэтому общая стоимость обычно выше. Сначала обрежьте референсное видео, прежде чем снижать разрешение, если хотите сэкономить.
У трёх моделей НЕ одинаковая цена — никогда не считайте их равными. При одинаковых разрешении и длительности цена за token возрастает в порядке mini < fast < standard (например, 720p/5 с: mini ≈ ¥3.16, fast ≈ ¥5.08, standard ≈ ¥6.35), что соответствует официальной ценовой шкале. Для пакетного производства mini экономит больше всего средств и времени (в наших тестах 2026-07 её эффективная цена за единицу в точности совпала с номинальной ставкой платформы: отклонение 0.00%); разрешение 1080p доступно только для standard.
Примечание: «CNY» — списание по прайс-листу платформы; «Общая цена ÷1.1» и «Для крупного клиента ÷1.2» — эффективные цены после бонуса за пополнение в размере 10% / 20%; после применения бонуса клиенты с крупным пополнением платят примерно 1.05× от официальной ориентировочной цены, а обычные клиенты — около 1.15×. Авторитетным источником данных об использовании является возвращаемый usage.completion_tokens.

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

2.5 и семейство 2.0 используют одну и ту же группу SeeDance2 и одинаковый коэффициент тарифа 0.18x — разница между поколениями обусловлена исключительно базовыми ценами самих моделей. 720p/5 с стоит $1.3721 на 2.5 против $0.9074 на стандартной модели 2.0, то есть примерно в 1.5x раза дороже. Этот разрыв отражает официальные прайс-листы Volcengine (их тариф за token для 2.5 примерно на 52% выше, чем для 2.0); это не наценка APIYI. Оправданность перехода зависит от того, нужны ли вам 30-секундные ролики, 30 референсных изображений, вывод в формате mov или редактирование/продление видео — если нет, стандартная модель 2.0 обойдется дешевле и также поддерживает 1080p. ① Без видео во входных данных (text-to-video, image-to-video, референсные изображения): ② С видео во входных данных (мультимодальный референс с video_url, редактирование видео, продление видео): тарифицируется по отдельному, более низкому тарифу за token. Более низкий тариф не означает меньший итоговый счет: при наличии видео во входных данных оплачиваемые tokens = (длительность входного видео + длительность на выходе) × площадь, поэтому само количество tokens возрастает. Строка выше стоила бы $1.0945 по тарифу ①; по тарифу ② она составляет $0.6567. Два тарифа за token: Как количество 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). Стоимость масштабируется строго пропорционально длительности, поэтому проверяйте prompt на 5-секундных роликах, прежде чем генерировать длинные клипы.
  3. Длительность референсного видео также тарифицируется. При использовании video_url каждая секунда входного видео конвертируется в tokens с разрешением выхода и рассчитывается вместе с результатом — как на 2.0, так и на 2.5. Предварительное списание учитывает только длительность на выходе, поэтому окончательный расчет по таким задачам часто в несколько раз превышает сумму холда; это ожидаемое поведение.
Таблицы выше и таблица для 2.0, приведенная ранее, относятся к группе SeeDance2 с коэффициентом 0.18x, поэтому их можно сравнивать напрямую.
Примечания по тарификации:
  • Итоговые списания соответствуют тарифам на модели в консоли и логам вызовов
  • При отправке задач выполняется предварительное списание, а окончательный расчет — по завершении: ваш баланс кратковременно колеблется; сверяйте его по логам вызовов, где одно видео создает две записи о списании (см. раздел «Чтение списаний в логах» ниже)
  • Сумма удержания зависит только от длительности и не зависит от разрешения: $0.09/секунда для семейства 2.0, $0.135/секунда для 2.5. Поэтому для 1080p обычно происходит доначисление, а для 480p — частичный возврат средств; обе ситуации нормальны
  • Отклоненные запросы (ошибки параметров HTTP 400 и т. д.) не тарифицируются (проверено)
  • Стоимость линейно зависит от длительности: видео длительностью 15 с стоит примерно в 3 раза дороже, чем 5 с

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

Откройте страницу логов консоли по адресу 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; надёжные партнёры каналов продаж могут связаться с нами. Эта модель тарифицируется для обеспечения поставок и обслуживания клиентов, а не для получения прибыли.

​
Поиск стоимости одного видео по ID задачи: используйте task API

Для программной сверки не пытайтесь сопоставлять записи логов по одной: ни одна из двух записей лога видео не содержит task_id, а запись расчёта имеет пустое request_id (так это работает на документированном пути /seedance/api/v3/...). Используйте task API и выполняйте запрос напрямую по task_id, аутентифицируясь тем же системным token, что и для Log Query API:
Возвращаемое значение quota — это общая стоимость видео (предварительное списание + расчёт, ÷ 500 000 = USD). Это то же число, которое вы получите, сложив две записи логов, и то же quota, отображаемое в деталях задачи на странице «Асинхронные задачи». Интерпретируйте его по status: Обратите внимание, что используются разные словари: эндпоинт запроса видео /seedance/api/v3/.../tasks/{id} сообщает об успехе как succeeded, тогда как task API /api/task/self сообщает о нём как completed.
Параметры пагинации task API противоположны параметрам Log Query API: здесь используется snake_case page_size, а номер страницы p начинается с 1; log API использует camelCase pageSize, где p начинается с 0. Ошибка не вызывает ошибку, вы просто получите страницу по умолчанию. Проверенные фильтры: task_id, model_name, start_timestamp / end_timestamp (Unix seconds).
Если необходимо выполнить ручную перекрёстную проверку в Log Query API: timestamp записи расчёта совпадает с finish_time задачи (с точностью до 1 секунды), её completion_tokens равен usage.completion_tokens задачи, other.final_quota равен quota задачи, а other.original_quota — это предварительное списание. Когда несколько задач отправляются в одну и ту же секунду, их записи предварительного списания совпадают, поэтому это подходит только для ручных проверок, но не для автоматического сопоставления. Полное руководство: Как найти фактическую стоимость видео по task_id.

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

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

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

Создайте один token с включенной группой SeeDance2 — он обеспечивает доступ ко всем четырем моделям, при этом в коде меняется только поле model. Моделью тарификации должна быть Pay-as-you-go Priority (или Pay-as-you-go). Для рабочей среды рекомендуется использовать отдельный token для каждого бизнес-направления, чтобы ограничивать квоту, настраивать оповещения и отслеживать непредвиденные расходы.
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 — основной шлюз; b.apiyi.com и другие домены платформы работают одинаково. Префикс пути — /seedance/api/v3 — не опускайте сегмент /api.
Не отправляйте задачи Seedance через общие эндпоинты генерации видео. В настоящее время /v1/videos, /v1/video/generations и /v2/videos/generations передают параметр Seedance resolution не полностью — в продакшене мы зафиксировали запросы 2.5 с рендерингом 480p в 720p и запросы семейства 2.0 с рендерингом 1080p в 720p, при этом тарификация производилась по фактически отрендеренным tokens (в первом случае в 2,25 раза больше). Проблема выявлена и устраняется (2026-09-14); до тех пор используйте только эндпоинты /seedance/api/v3/... на этой странице, где разрешение соблюдается. Если с вас была списана плата за некорректное разрешение на общем эндпоинте, обратитесь в службу поддержки для возврата разницы на основе запрошенного разрешения.

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

Уровень разрешения определяет площадь в пикселях, а не короткую сторону. Фактические размеры вывода для каждого соотношения (официальные значения, проверенные в наших тестах):
В 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-Shellapi-Request-Id (ID запроса APIYI, доступный для поиска в логах; X-Request-Id — ID на стороне провайдера)

​
FAQ

Замедляется именно отправка, а не генерация. Ваши медиафайлы должны передаться вышестоящему провайдеру в APIYI, затем перенаправиться в Volcengine, где они декодируются и проходят валидацию — task ID возвращается только после завершения всех этих шагов. При использовании инлайн-base64 или больших URL изображений этот этап вместо одной секунды занимает десятки секунд, и даже 60-секундного клиентского таймаута на чтение может не хватить. Сама генерация обычно занимает 2–5 минут, что является штатной скоростью провайдера и не связано с отправкой.Реальное решение — предварительно загрузить медиафайл и сослаться на него через ID ассета asset://, что уменьшает тело запроса с мегабайтов до нескольких десятков байт. Подробный разбор задержек, шаги миграции и способ проверить, была ли создана задача после таймаута, см. в разделе Asset-First Workflow.
Выбирайте исходя из необходимых возможностей — 2.5 не является автоматическим выбором по умолчанию. Она стоит примерно в 1.5 раза дороже стандартной модели 2.0 (720p/5s: $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 убедитесь, что ваш пайплайн обработки способен его декодировать.
Обе операции являются задачами «omni reference», запускаемыми референсным видео в content в сочетании с намерением, выраженным в вашем prompt. Передавайте omni_reference_task_type явно, чтобы ошибки выявлялись на раннем этапе:
  • Редактирование видео: omni_reference_task_type: "edit", как минимум один role: "reference_video", ratio должен быть adaptive, а duration должен быть -1, а исходное видео должно длиться от 4 до 30 секунд. В prompt должен присутствовать глагол редактирования (add, remove, delete, change, replace). Соотношение сторон и длительность результата соответствуют исходному видео — при этом длительность может быть дробной (в тестовом запуске было получено 16.709 секунды).
  • Продление видео: omni_reference_task_type: "extend", также с референсным видео и ratio, установленным в adaptive. В prompt должен присутствовать глагол продления (extend, continue).
Ссылайтесь на ассеты в prompt по их позиции — @video1, @image1 — в том порядке, в котором вы их передали. Недопустимые параметры возвращают 400 при отправке (InvalidParameter.TaskTypeConstraint), вместо сбоя задачи через несколько минут.
Передача "output_format": "mov" возвращает контейнер QuickTime (H.264 + цветовая субдискретизация yuv444p + звук PCM) с более высокой точностью цветопередачи и яркости — формат оптимизирован для цветокоррекции, кеинга и композитинга, а также официально рекомендуется как для входа, так и для выхода при задачах редактирования / продления видео. По умолчанию используется mp4, обладающий максимальной совместимостью.Обратите внимание, что в mov используются профессиональные кодеки, которые не могут открыть некоторые плееры (VLC, mpv, ffplay и IINA на macOS без проблем с ними работают). Для прямой публикации в вебе или на мобильных устройствах оставайтесь на стандартном mp4.
Это самая частая ошибка в Seedance, и в девяти случаях из десяти у токена включена не та группа. В тексте ошибки указывается группа, на которой вы сейчас находитесь, например:
Сопоставьте вашу модель с ее группой и включите ее в настройках токена (Token Settings):Один ключ с включенной группой SeeDance2 дает доступ ко всем четырем моделям (существующие токены с SD2Fast / SD2Mini по-прежнему могут вызывать свою отдельную модель по той же цене). Модель биллинга также должна быть 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 дней, использовать предустановленные виртуальные аватары платформы (ID asset://) или использовать лицензированные ассеты лиц.
Нет. Загрузка виртуальных аватаров, верификация реальных людей и остальная часть приватной библиотеки ассетов бесплатны при использовании Seedance 2.0 API на APIYI — без ежегодной платы. Официально эта функциональность представляет собой отдельно приобретаемую опцию: годовой контракт с шестизначной суммой в юанях (CNY) для клиентов без рамочного соглашения (Volcengine также продает ее напрямую). Мы ценим постоянных пользователей, поэтому эти затраты уже заложены в цену нашего API; для клиентов, использующих SD2 API в обычном режиме, при стандартных объемах бизнеса дополнительная плата отсутствует. Инструкции по использованию см. в разделе Asset Library.
При отклонении параметров (HTTP 400) тарификация не взимается (проверено). Оплата предварительно блокируется при отправке и окончательно списывается по завершении, поэтому ваш баланс кратковременно колеблется — сверяйте его по журналам вызовов.
tokens ≈ duration(s) × width × height × 24 / 1024, подтверждено с точностью до 0.1%. Любое соотношение сторон в рамках одного уровня имеет одинаковую площадь в пикселях (720p 16:9 и 9:16 стоят 108,900 tokens за каждые 5 с) — горизонтальное, вертикальное и квадратное видео стоят одинаково.
Цена и скорость распределяются как mini < fast < standard (номинально на платформе для 720p/5s: около ¥3.16 / ¥5.08 / ¥6.35). Выбирайте mini для пакетного производства и задач с жестким бюджетом — примерно в два раза дешевле standard и самая быстрая генерация (замеры за июль 2026: ~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, ни в серии 2.0. Вместо этого используйте целочисленный duration.
Нет — это три взаимоисключающих режима: первый+последний кадр (2 изображения с обязательными ролями first_frame/last_frame), первый кадр (1 изображение) и мультимодальный reference-to-video (роль изображения reference_image). Чтобы сымитировать режим «первый/последний кадр + референс», используйте режим референса и укажите кадр через prompt.Ограничения по референсам различаются в зависимости от поколения: 2.5 принимает 30 изображений + 10 видео + 10 аудиоклипов, причем аудио может передаваться отдельно; семейство 2.0 принимает 9 изображений + 3 видео + 3 аудиоклипа и требует наличия хотя бы 1 изображения или 1 видео вместе с любым аудио.
Группа SeeDance2 обладает достаточной емкостью параллельных запросов и работает без очередей (в нашем тесте 15 одновременных задач запустились мгновенно). Для стабильной работы с более крупными объемами свяжитесь с отделом продаж.
Старайтесь укладывать prompt примерно в 500 китайских иероглифов или 1000 английских слов — более длинные prompt размывают детализацию. Поддерживаемые языки: китайский, английский, японский, испанский, португальский, индонезийский. Описывайте объект + действие + движение камеры + освещение/стиль.

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

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