API Doubao Seedance 2.0 использует асинхронный маршрут для видео. Вы отправляете текст и поддерживаемые сочетания изображений, видео или аудио. OdiRouter возвращает URL-адреса задач, чтобы ваше приложение могло проверять задачу, получать готовое видео или отменять её.
Начните с маршрута OdiRouter
Модель представлена в видеокаталоге OdiRouter. Её поставщик — ByteDance. Используйте идентификатор модели seedance-2-0 с базовым URL-адресом https://api.odirouter.ai/model. Для каждого запроса требуется Authorization: Bearer YOUR_API_KEY.
Создайте задачу с помощью POST /v1/queue/seedance-2-0. Ответ содержит request_id и отдельные URL-адреса для статуса, результата и отмены. Это разделение важно, поскольку генерация видео может длиться дольше исходного HTTP-запроса.
На странице модели OdiRouter отображается текущая доступность:
https://odirouter.ai/models/seedance-2-0
Выберите подходящий режим ввода
Массив content может содержать текст и несколько типов медиафайлов. OdiRouter описывает запросы только с текстом, текстом и изображением, текстом и видео, а также мультимодальные запросы, объединяющие изображения, видео и аудио.
Роли сообщают модели, как использовать каждый элемент. Используйте reference_image, reference_video или reference_audio для справочных материалов. Используйте first_frame и last_frame для строго заданного процесса с первым и последним кадрами. Этот процесс отличается от мультимодальной генерации по референсам, поэтому не смешивайте эти два режима, не проверив документированные правила.
Для изображений можно использовать публичный URL-адрес, данные Base64 или идентификатор asset://. Сначала необходимо настроить форму учета активов: создайте группу активов Seed, загрузите актив, а затем используйте полученный идентификатор в image_url.
Для аудио действует ещё одно правило. Запрос с аудио также должен содержать хотя бы одно эталонное изображение или видео. Обнаружьте эту ошибку на стороне клиента до отправки задания.
Сначала отправьте небольшой запрос
В этом примере используется официальная форма запроса OdiRouter и короткое общедоступное видео-образец:
curl --request POST \
'https://api.odirouter.ai/model/v1/queue/seedance-2-0' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"content": [
{
"type": "text",
"text": "A dancer crosses a quiet studio while the camera tracks from left to right"
},
{
"type": "video_url",
"video_url": {
"url": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
},
"role": "reference_video"
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true,
"watermark": false
}'Не помещайте ключ в систему контроля версий. Замените промпт и URL-адрес медиафайла файлами, которые соответствуют задокументированным ограничениям по формату и размеру.
Осознанно выбирайте параметры вывода
Длительность по умолчанию составляет 5 секунд. Можно указать целое число от 4 до 15 либо -1, чтобы позволить модели выбрать длительность. Поскольку длительность влияет на стоимость, явно задавайте её в рабочем коде.
Разрешение по умолчанию — 720p. Другие задокументированные варианты: 480p, 1080p и 4k. Вариант 4K использует 10-битный вывод H.265, поэтому убедитесь, что следующий этап вашего медиаконвейера может его декодировать.
Соотношение сторон по умолчанию — adaptive. Фиксированные варианты: 16:9, 4:3, 1:1, 3:4, 9:16 и 21:9. В адаптивном режиме модель выбирает вариант на основе промпта или исходного медиафайла в зависимости от типа запроса.
Генерация аудио включена по умолчанию через generate_audio: true, а создаваемый звук — монофонический. Отключите её для вывода без звука. Добавление водяных знаков по умолчанию отключено. Укажите watermark: true, если хотите разместить сгенерированную ИИ метку в правом нижнем углу.
Проверяйте эталонные медиафайлы перед загрузкой
Seedance 2.0 поддерживает до девяти эталонных изображений. Поддерживается до трёх эталонных видео, длительностью от 2 до 15 секунд каждое, с общим ограничением в 15 секунд. Для эталонного аудио действуют те же ограничения по количеству и длительности.
В официальной документации также указаны форматы, размеры, количество пикселей и размеры файлов. Проверка этих значений перед загрузкой позволяет пользователям получить полезное сообщение об ошибке, пока исходный файл еще доступен. Для медиафайлов, которые вы будете использовать повторно, идентификатор ресурса проще в управлении, чем встраивание одной и той же полезной нагрузки Base64 в каждый запрос.
Обрабатывайте задачу как элемент очереди
Сохраните request_id и полученные URL-адреса. Жизненный цикл включает четыре этапа:
Создайте задачу с помощью
POST /v1/queue/seedance-2-0.Проверьте её с помощью
GET /v1/queue/seedance-2-0/requests/{request_id}/status.Получите результат с помощью
GET /v1/queue/seedance-2-0/requests/{request_id}/response.Отмените её с помощью
PUT /v1/queue/seedance-2-0/requests/{request_id}/cancel.
Выполняйте опрос с задержкой и предельным сроком. Частый цикл лишь создаёт лишний трафик. Считайте сбой и отмену обычными конечными состояниями и сохраняйте настройки запроса, необходимые для диагностики недопустимого медиафайла или неподдерживаемой комбинации.
Перед переходом в рабочую среду
Проверьте идентификатор модели
seedance-2-0.Используйте базовый URL модели OdiRouter и заголовок аутентификации.
Размещайте текст и медиафайлы в задокументированной структуре
content.Назначьте каждому медиообъекту правильную роль.
Проверяйте правила по количеству, длительности, формату, размеру и сочетаниям.
Сохраняйте
request_idи возвращённые URL-адреса задач.Определите поведение опроса, тайм-аута и отмены.
Перед выбором длительности и разрешения проверьте актуальные цены.
В официальном справочнике API приведена полная схема запросов и ответов:
https://odirouter.ai/docs/api-reference/model-api/bytedance/seedance-2-0
Используйте актуальную страницу цен OdiRouter для получения текущей информации о стоимости:
Сравните другие поддерживаемые модели в каталоге OdiRouter: