Создать видео

Создание видеозадачи Seedance 2.0 через API платформы Video Generations.

Поддерживаются текст, изображения, видео и аудио для генерации видео по тексту, управления начальным или начальным и конечным кадрами и генерации по опорным материалам.

Если требуется использовать структуру запроса Volcengine Ark напрямую, см. нативный интерфейс создания.

Стандартная Seedance 2.0 поддерживает 480p/720p/1080p/4k; Seedance 2.0 fast — только 480p/720p. Выбирайте разрешение с учётом используемой модели.

POST/v1/video/generations

Создавайте асинхронные задачи генерации видео. После успешной отправки возвращается ID задачи; видео не возвращается синхронно через этот интерфейс.

Поддерживаются модели doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 и другие. Фактическая доступность определяется списком моделей текущего ключа API.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры генерации видео Seedance 2.0.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели Seedance 2.0 или точки подключения инференса (Endpoint), настроенной для этой модели. Поддерживаются doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128; фактическая доступность определяется текущим ключом API.

Длина1 <= length

content*array<>

Список входных данных. Режим референсов: до 9 изображений, 3 видео и 3 аудиофрагментов. Каждый видео- или аудиофрагмент длится 2–15 секунд, суммарно до 15 секунд на тип. Аудио требует хотя бы одного изображения или видео. Режимы первого и первого/последнего кадров нельзя смешивать с мультимодальными референсами.

Элементы1 <= items

generate_audio?boolean

Генерировать ли звук, синхронизированный с изображением. При true модель может создавать соответствующие текстовому запросу и визуальному содержимому голоса, звуковые эффекты и фоновую музыку; при false выводится видео без звука.

ratio?string

Соотношение сторон видео. Seedance 2.0 и Seedance 2.0 fast по умолчанию используют adaptive, автоматически выбирая подходящее соотношение по входным данным.

По умолчанию"adaptive"

Допустимые значения

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|unknown

Длительность видео в секундах. Seedance 2.0 и Seedance 2.0 fast поддерживают целые числа от 4 до 15 или -1 для выбора длительности моделью.

resolution?string

Разрешение видео, по умолчанию 720p. Стандартная Seedance 2.0 поддерживает 480p/720p/1080p/4k; Seedance 2.0 fast — только 480p/720p.

По умолчанию"720p"

Допустимые значения

"480p"
"720p"
"1080p"
"4k"

watermark?boolean

Добавлять ли водяной знак в сгенерированное видео.

seed?integer

Случайное начальное значение в диапазоне от -1 до 4294967295. Одинаковое значение повышает воспроизводимость, но не гарантирует полного совпадения.

Диапазон-1 <= value <= 4294967295

return_last_frame?boolean

Возвращать ли последний кадр JPEG без водяного знака для последовательной генерации видео.

callback_url?string

Адрес для POST callback при изменении состояния задачи. Структура тела callback совпадает с ответом интерфейса получения задачи; если не задан, состояние можно опрашивать.

Форматuri

safety_identifier?string

Стабильный уникальный идентификатор конечного пользователя для выявления возможных нарушений правил использования. Рекомендуется передавать хеш имени пользователя, ID или адреса электронной почты, избегая передачи персональных данных.

Длина1 <= length <= 64

execution_expires_after?integer

Срок действия задачи в секундах с момента создания. Незавершённые к этому времени задачи прекращаются и помечаются expired.

Форматint32

Диапазон3600 <= value <= 259200

По умолчанию172800

tools?array<>

Список инструментов, которые модель может вызывать, например web_search. Типы инструментов и их расширенные параметры определяются возможностями текущей модели и аккаунта.

service_tier?string

Уровень обслуживания задачи. Seedance 2.0 и Seedance 2.0 fast используют default для онлайн-инференса и не поддерживают flex для офлайн-инференса.

По умолчанию"default"

priority?integer

Приоритет очереди в одной точке инференса, от 0 до 9. Более высокое значение имеет преимущество; равные приоритеты обрабатываются в порядке отправки. Выполняемые задачи не прерываются.

Диапазон0 <= value <= 9

По умолчанию0

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "Рождественский кролик летит"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 11,    "resolution": "1080p",    "watermark": false,    "execution_expires_after": 172800  }'

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

Официальная документация Volcengine Ark по созданию задач генерации видеоОпределения протокола вышестоящего сервиса и последние изменения полей задач генерации видео Seedance.

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`