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

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

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

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

Чтобы проверить черновик низкого разрешения перед созданием итогового видео, см. руководство по черновикам Draft. Черновик использует 480p, а итоговое видео на его основе — 1080p.

POST/v1/video/generations

Используйте путь Video Generations платформы для создания асинхронных видеозадач Seedance 2.5. Интерфейс возвращает объект задачи и ID для получения результата.

Seedance 2.5 поддерживает видео длительностью до 30 секунд, до 50 мультимодальных опорных материалов и вывод в mp4 и mov. Для редактирования видео ratio должен быть adaptive, а duration — -1.

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

bearerAuth

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

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

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

Тело запроса

application/json

Параметры генерации видео Seedance 2.5. Разные типы задач имеют разные ограничения на роли материалов, соотношение сторон и длительность.

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

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

model*string

ID модели Seedance 2.5, например doubao-seedance-2-5-260628. При вызове используйте модели, доступные текущему ключу API.

Длина1 <= length

content*array<|>

Список входных данных: текст, изображения, видео, аудио или ID задачи Draft. Мультимодальные референсы: до 50 материалов, включая 30 изображений, 10 видео и 10 аудиофрагментов. Длительность каждого видео или аудио — 2–30 секунд, суммарно до 30 секунд на тип. Для редактирования нужно видео 4–30 секунд. Поддерживается только аудио без других референсов. Режимы первого и первого/последнего кадров нельзя смешивать с мультимодальными референсами.

Ссылайтесь на материалы по порядку в массиве: @image1, @video1, @audio1.

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

draft?boolean

Создавать ли черновик Draft. При true требуется 480p. После успешного создания используйте content.draft_task.id в течение семи дней для итогового видео 1080p. При итоговой генерации пропустите поле или укажите false.

omni_reference_task_type?string

Тип мультимодальной задачи. auto — автоопределение; reference — генерация по референсам; edit — редактирование с видео, ratio=adaptive и duration=-1; extend — продление с видео и ratio=adaptive. Явный тип позволяет проверить ограничения заранее. Смысл запроса должен соответствовать выбранному типу.

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

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

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

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

ratio?string

Соотношение сторон видео. Для генерации по тексту и мультимодальным материалам можно задать соотношение или adaptive; задачи по начальному кадру, начальному и конечному кадрам, редактирования и продления видео поддерживают только adaptive.

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

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

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

duration?|integer

Длительность генерации в секундах. Поддерживается от 4 до 30 или -1 для автоматического выбора моделью. Редактирование видео поддерживает только -1, продление — от 4 до 30 или -1.

По умолчанию-1

resolution?string

Разрешение выходного видео: 480p, 720p или 1080p. Фактические размеры в пикселях определяются разрешением, соотношением сторон и возможностями текущей модели.

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

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

"480p"
"720p"
"1080p"

output_format?string

Формат выходного видео. mp4 подходит для веба и обычного распространения; mov использует H.264, YUV444P и PCM и подходит для цветокоррекции, кеинга и композитинга.

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

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

"mp4"
"mov"

watermark?boolean

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

seed?integer

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

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

return_last_frame?boolean

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

callback_url?string

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

Форматuri

safety_identifier?string

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

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

execution_expires_after?integer

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

Форматint32

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

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

tools?array<>

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

service_tier?string

Уровень сервиса. Seedance 2.5 использует онлайн-инференс default и не поддерживает flex. Приоритет очереди задаётся отдельным параметром priority.

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

priority?integer

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

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

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

[key: string]?any

Тело ответа

`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": 10,    "resolution": "1080p",    "output_format": "mp4",    "watermark": false  }'

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1786082400
}

Официальная документация 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`