Перейти до основного вмісту
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.

Відома поведінка обгортки

Volcengine і Seedance документують це сімейство як асинхронний робочий процес створення з подальшим запитом статусу. CometAPI зберігає той самий шаблон завдань, але надає вам одну базову URL-адресу та один API key.
Під час живої валідації 2026-03-12 цей маршрут був доступний, але все ще повертав серверну помилку парсингу JSON для стандартного JSON-прикладу. Сприймайте наведені тут OpenAPI-приклади як практичний еталон для обгортки та перевіряйте свій 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.