Skip to main content
POST
Публичное имя модели Seedance 2.5 — seedance-2-5, ID модели Volcengine — doubao-seedance-2-5-260628.
  • Поддерживаются text-to-video, первый/первый и последний кадр, редактирование, продление видео и мультимодальные ссылки.
  • Можно использовать ссылки на изображения, видео и аудио, включая только аудио.
  • Задача асинхронная: после отправки возвращается generation.task, а готовое видео получается через API статуса задачи.

​
Authorizations

​
string
обязательно
Все запросы требуют Bearer Token. Получите ключ на странице управления API Key и передайте Authorization: Bearer YOUR_API_KEY.

​
Body

​
string
по умолчанию:"seedance-2-5"
обязательно
Публичное имя модели ToAPIs: seedance-2-5.
​
string
Опишите сцену, движение камеры, действие объекта, стиль и атмосферу звука. Ссылки обозначайте как «изображение 1», «видео 1», «аудио 1».
​
string
по умолчанию:"generate"
Операция: generate, edit или extend. Для редактирования и продолжения нужен хотя бы один video_with_roles; для продолжения нужна положительная duration. Все операции используют этот endpoint.
​
string
Номер заказа или внутренний ID задания. Доступен для поиска через GET /v1/videos/generations/{client_business_id}.
​
integer
Длительность в секундах: 4–30; -1 означает автоматическую длительность. Для редактирования, продления и заданий с кадрами используйте -1, если это требует upstream.
​
string
21:9, 16:9, 4:3, 1:1, 3:4, 9:16 или adaptive. Для редактирования, продления и первого/последнего кадра используйте adaptive.
​
string[]
Массив URL изображений для совместимости. Для новых интеграций используйте image_with_roles; оба поля нельзя передавать одновременно.
​
array
Массив изображений с url и role. Роли: first_frame, last_frame, reference_image; максимум 30 изображений. Режим кадров нельзя смешивать с режимом reference.
​
array
Массив референсных видео с ролью reference_video; максимум 10 видео.
​
array
Массив референсного аудио с ролью reference_audio; максимум 10 фрагментов. Допускается только аудио.
​
string
Разрешение: 480p или 720p.
​
string
по умолчанию:"mp4"
Поддерживаются mp4 и mov.
​
boolean
по умолчанию:true
Генерировать ли синхронное аудио.
​
boolean
по умолчанию:false
Возвращать ли изображение последнего кадра в результате.
​
array
Доступное значение: [{ "type": "web_search" }]. Работает только для text-to-video без медиа-входов.
​
string
URL обратного вызова завершения задачи ToAPIs. См. Task Webhooks.
​
string
Идентификатор трассировки, заданный клиентом.

​
Ограничения референсов

Всего не более 50 материалов: 30 изображений, 10 видео и 10 аудиофрагментов. Используйте явные роли.
Неверная комбинация может завершиться асинхронной ошибкой InvalidParameter.TaskTypeConstraint. Для редактирования, продления и кадровых задач задавайте aspect_ratio=adaptive.

​
Response

​
string
ID задачи для проверки статуса.
​
string
Возвращается, если поле было передано.
​
string
Всегда generation.task.
​
string
Имя запрошенной модели.
​
string
queued, in_progress, completed или failed.
​
integer
Прогресс от 0 до 100.
​
integer
Временная метка создания.