Перейти к основному содержанию
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
Используйте этот endpoint, чтобы запустить задачу видео ByteDance Seedance из текста или из текста с эталонными изображениями. Запрос сразу возвращает id задачи, а рендеринг продолжается асинхронно.

Выберите текущий путь модели

  • Используйте страницу Models, чтобы узнать о текущей доступности моделей и их идентификаторах.
  • Используйте doubao-seedance-1-5-pro-251215 как актуальный production-пример для этого маршрута.
  • Одна и та же текущая модель может обрабатывать как запросы только с текстом, так и запросы с изображениями через единый массив content.

Поток задачи

1

Соберите массив content

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

Отправьте задачу

Сохраните возвращённый id задачи. Если вам нужна push-доставка, задайте callback_url при создании задачи.
3

Опрашивайте до появления результата

Вызывайте ByteDance Video Query, пока задача не завершится и не появится content.video_url.

Известное поведение wrapper

Volcengine и Seedance документируют это семейство как асинхронный рабочий процесс create-then-query. CometAPI сохраняет тот же шаблон задач, но предоставляет вам один base URL и один API key.
Во время живой проверки 2026-03-12 этот маршрут был доступен, но всё ещё возвращал серверную ошибку разбора JSON для стандартного JSON-примера. Считайте примеры OpenAPI здесь практическим справочником по wrapper и проверяйте ваш payload на ранних этапах разработки.

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json
model
string
обязательно

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Пример:

"doubao-seedance-1-5-pro-251215"

content
object[]
обязательно

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

callback_url
string

Optional webhook URL for task status notifications.

Ответ

200 - application/json

Task accepted.

id
string
обязательно

Task id for later polling.