doubao-seedance-2-0
doubao-seedance-2.0 — генерация видео
- Асинхронный режим обработки, возвращает ID задачи для последующих запросов
- Поддержка генерации видео из текста, из изображения (первый кадр / последний кадр)
- Поддержка референсного видео, референсного аудио и видео со звуком
- Поддержка горизонтального, вертикального, квадратного, сверхширокого и адаптивного соотношения сторон
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Аутентификация
Все эндпоинты API требуют аутентификации через Bearer TokenПолучите ваш API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Параметры запроса
Имя модели генерации видеоПоддерживаемые модели:
doubao-seedance-2.0— стандартная версия, поддерживает текст-в-видео, изображение-в-видео, видео из первого/последнего кадра, референсное видео, референсное аудио и видео со звукомdoubao-seedance-2.0-fast— быстрая версия, те же функции, что и стандартная, с более высокой скоростью генерацииdoubao-seedance-2.0-face— поддерживает загрузку реальных людей, те же функции, что и стандартная версияdoubao-seedance-2.0-fast-face— поддерживает загрузку реальных людей, те же функции, что и быстрая версия
Описание содержимого видеоОбязательно для генерации текст-в-видео; необязательно для изображение-в-видео или видео-референс-в-видеоРекомендуется чётко указывать объект, действие, движение камеры и стиль для лучших результатов генерацииПример:
"A kitten yawning at the camera"Длительность видео (в секундах)Поддерживаемый диапазон: от
4 до 15 секундПо умолчанию: 5Соотношение сторон видеоВарианты:
16:9— горизонтальное9:16— вертикальное1:1— квадратное4:3— традиционное соотношение3:4— вертикальное традиционное соотношение21:9— сверхширокоеadaptive— адаптивное (автоматически соответствует входному изображению/видео)
16:9Разрешение видеоВарианты:
480p— стандартное разрешение720p— высокое разрешение1080p— Full HD (поддерживается только моделямиdoubao-seedance-2.0-faceиdoubao-seedance-2.0)
480pСлучайное seed-значение для управления случайностью генерируемого контента
- При одинаковом запросе разные seed-значения дадут разные результаты
- При одинаковом запросе одинаковое seed-значение даст похожие результаты, но точная идентичность не гарантируется
Генерировать ли аудио (видео со звуком)При значении
true видео будет содержать сгенерированное ИИ сопровождающее аудиоПо умолчанию: falseВозвращать ли изображение последнего кадраПри значении
true в результате задачи дополнительно будет возвращён URL изображения последнего кадра видео, который можно использовать для непрерывной генерации видеоПо умолчанию: falseСписок инструментов для расширенных возможностей, таких как веб-поискПример:
[{"type": "web_search"}]Массив URL изображений для генерации изображение-в-видеоПоддерживает два формата:
- Обычный URL изображения:
https://example.com/cat.jpg - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/cat.jpg"] или ["asset://asset_a"]URL ассета поддерживается только моделями
doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.Массив изображений с ролями, поддерживает указание первого/последнего кадраПример:Формат URL ассета:
Когда в поле
url используется URL ассета, поддерживаются только модели doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.Массив URL референсных видеоПоддерживает два формата:
- Обычный URL видео:
https://example.com/reference.mp4 - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/reference.mp4"] или ["asset://asset_a"]URL ассета поддерживается только моделями
doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.Массив URL референсного аудиоПоддерживает два формата:
- Обычный URL аудио:
https://example.com/speech.wav - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/speech.wav"] или ["asset://asset_a"]URL ассета поддерживается только моделями
doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.Ответ
Код состояния ответа, 200 при успехе
Массив данных ответа
Сценарии использования
Сценарий 1: текст-в-видео
Сценарий 2: изображение-в-видео (первый кадр)
Сценарий 3: видео из первого/последнего кадра
Сценарий 4: видео из референсного видео
Сценарий 5: референсное видео + референсное аудио
Сценарий 6: видео со звуком
Сценарий 7: непрерывная генерация видео (возврат последнего кадра)
Сценарий 8: генерация в быстрой версии
Сценарий 9: референсные изображения + референсное видео + референсное аудио (мультимодальное видео)
Сочетайте референсные изображения, референсное видео и референсное аудио, чтобы создать иммерсивное рекламное видео от первого лица. Идеально подходит для продвижения товаров, рекламы брендов и других сценариев, требующих объединения материалов из нескольких источников.Сценарий 10: изображение-в-видео с URL ассета
Одобренные ассеты виртуальных аватаров можно передавать напрямую как референсные изображения без повторной загрузки и повторной модерации.Сценарий 11: указание референсного портрета с URL ассета (image_with_roles)
Сценарий 12: быстрая версия + URL ассета для изображение-в-видео
Сценарий 13: изображение через URL ассета + референсное видео (перенос движений)
Сочетайте одобренный портретный ассет с референсным видео, чтобы заставить персонажа выполнять заданные движения.Запрос результатов задачиГенерация видео — это асинхронная задача, которая при отправке возвращает
task_id. Используйте эндпоинт Получение статуса задачи, чтобы запросить прогресс и результаты генерации.Отличия от версии 1.5 Pro
| Функция | 1.5 Pro | 2.0 / 2.0 fast |
|---|---|---|
| Разрешение | 480p/720p/1080p | 480p/720p |
| Диапазон длительности | 4-12 с | 5-15 с |
| Длительность по умолчанию | 5 с | 5 с |
| Параметр соотношения сторон | aspect_ratio | size (новая опция adaptive) |
| Генерация аудио | Параметр audio | Параметр generate_audio |
| Референсное видео | Не поддерживается | Поддерживается через video_urls |
| Референсное аудио | Не поддерживается | Поддерживается через audio_urls |
| Изображение-в-видео | image_urls / image_with_roles | image_urls / image_with_roles |
| Видео со звуком | Не поддерживается | Поддерживается через generate_audio |
| Непрерывное видео | Не поддерживается | Поддерживается через return_last_frame |
| Быстрая версия | Не поддерживается | Поддерживается через doubao-seedance-2.0-fast |