seedance-2-0
seedance-2.0 — генерация видео
- Асинхронный режим обработки, возвращает ID задачи для последующих запросов
- Поддержка генерации видео из текста, из изображения (первый кадр / последний кадр)
- Поддержка референсного видео, референсного аудио и видео со звуком
- Поддержка горизонтального, вертикального, квадратного, сверхширокого и адаптивного соотношения сторон
POST
Аутентификация
string
обязательно
Все эндпоинты API требуют аутентификации через Bearer TokenПолучите ваш API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Параметры запроса
string
обязательно
Имя модели генерации видеоПоддерживаемые модели:
seedance-2.0— стандартная версия, поддерживает текст-в-видео, изображение-в-видео, видео из первого/последнего кадра, референсное видео, референсное аудио и видео со звукомseedance-2.0-fast— быстрая версия, те же функции, что и стандартная, с более высокой скоростью генерацииseedance-2.0-mini— мини-версия, те же функции, что и стандартная версия
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.Ответ при обнаружении:
true: проверить промпты и входные изображения с помощьюomni-moderation-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
- Текст:
prompt,negative_prompt - Изображения:
image_urls,image_with_roles[].url,first_frame_image,last_frame_image - Приватные изображения
asset://: найти и проверить исходный публичный URL - Изображения Base64: проверить после преобразования в публичный URL
video_urls, audio_urls, а также приватные видео- и аудиоматериалы не проверяются, поскольку модель модерации не поддерживает видео и аудио.Поддерживаемые ID моделей: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (прежнее имя) и seedance-2.5.Сам вызов модерации не оплачивается пользователем, отправившим запрос на генерацию видео.Пример:string
Описание содержимого видеоОбязательно для генерации текст-в-видео; необязательно для изображение-в-видео или видео-референс-в-видеоРекомендуется чётко указывать объект, действие, движение камеры и стиль для лучших результатов генерацииПример:
"A kitten yawning at the camera"integer
по умолчанию:"5"
Длительность видео (в секундах)Поддерживаемый диапазон: от
4 до 15 секундПо умолчанию: 5string
по умолчанию:"16:9"
Соотношение сторон видеоСоотношение сторон должно быть в диапазоне 0.5–2.5Варианты:
16:9— горизонтальное9:16— вертикальное1:1— квадратное4:3— традиционное соотношение3:4— вертикальное традиционное соотношение21:9— сверхширокоеadaptive— адаптивное (автоматически соответствует входному изображению/видео)
16:9string
по умолчанию:"720p"
Разрешение видеоВарианты:
480p— стандартное разрешение720p— высокое разрешение1080p— Full HD (поддерживается только модельюseedance-2.0)4k— Ultra HD (поддерживается только модельюseedance-2.0)
720pinteger
Случайное seed-значение для управления случайностью генерируемого контента
- При одинаковом запросе разные seed-значения дадут разные результаты
- При одинаковом запросе одинаковое seed-значение даст похожие результаты, но точная идентичность не гарантируется
boolean
по умолчанию:"true"
Генерировать ли аудио (видео со звуком)При значении
true видео будет содержать сгенерированное ИИ сопровождающее аудиоПри значении false видео не будет содержать аудио (видео без звука)По умолчанию: trueboolean
по умолчанию:"false"
Возвращать ли изображение последнего кадраПри значении
true в результате задачи дополнительно будет возвращён URL изображения последнего кадра видео, который можно использовать для непрерывной генерации видеоПо умолчанию: falsearray<object>
Список инструментов для расширенных возможностей, таких как веб-поискПример:
[{"type": "web_search"}]array<string>
Массив URL изображений для генерации изображение-в-видеоПоддерживает два формата:
- Обычный URL изображения:
https://example.com/cat.jpg - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/cat.jpg"] или ["asset://asset_a"]URL ассета поддерживается всеми моделями Seedance 2.0:
seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.array
Массив изображений с ролями, поддерживает указание первого/последнего кадраПример:Формат URL ассета:
Когда в поле
url используется URL ассета, поддерживаются все модели Seedance 2.0: seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.array<string>
Массив URL референсных видеоПоддерживает два формата:
- Обычный URL видео:
https://example.com/reference.mp4 - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/reference.mp4"] или ["asset://asset_a"]URL ассета поддерживается всеми моделями Seedance 2.0:
seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.array<string>
Массив URL референсного аудиоПоддерживает два формата:
- Обычный URL аудио:
https://example.com/speech.wav - URL ассета (одобренный ассет):
asset://asset_a
["https://example.com/speech.wav"] или ["asset://asset_a"]URL ассета поддерживается всеми моделями Seedance 2.0:
seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.Ответ
integer
Код состояния ответа, 200 при успехе
array
Массив данных ответа
Сценарии использования
Сценарий 1: текст-в-видео
Сценарий 2: изображение-в-видео (первый кадр)
Сценарий 3: видео из первого/последнего кадра
Сценарий 4: видео из референсного видео
Сценарий 5: референсное видео + референсное аудио
Сценарий 6: видео со звуком
Сценарий 7: непрерывная генерация видео (возврат последнего кадра)
Сценарий 8: генерация в быстрой версии
Сценарий 9: референсные изображения + референсное видео + референсное аудио (мультимодальное видео)
Сочетайте референсные изображения, референсное видео и референсное аудио, чтобы создать иммерсивное рекламное видео от первого лица. Идеально подходит для продвижения товаров, рекламы брендов и других сценариев, требующих объединения материалов из нескольких источников.Сценарий 10: изображение-в-видео с URL ассета
Одобренные ассеты виртуальных аватаров можно передавать напрямую как референсные изображения без повторной загрузки и повторной модерации.Сценарий 11: указание референсного портрета с URL ассета (image_with_roles)
Сценарий 12: быстрая версия + URL ассета для изображение-в-видео
Сценарий 13: изображение через URL ассета + референсное видео (перенос движений)
Сочетайте одобренный портретный ассет с референсным видео, чтобы заставить персонажа выполнять заданные движения.Запрос результатов задачиГенерация видео — это асинхронная задача, которая при отправке возвращает
task_id. Используйте эндпоинт Получение статуса задачи, чтобы запросить прогресс и результаты генерации.