Naar hoofdinhoud gaan
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"
}
Gebruik dit endpoint om een ByteDance Seedance-videotaak te starten vanuit tekst, of vanuit tekst plus referentieafbeeldingen. De request retourneert direct een task id en de rendering gaat asynchroon verder.

​
Kies het huidige modelpad

  • Gebruik de Models-pagina voor de huidige beschikbaarheid van modellen en identifiers.
  • Gebruik doubao-seedance-1-5-pro-251215 als het huidige productievoorbeeld voor deze route.
  • Hetzelfde huidige model kan zowel tekst-only als image-guided requests verwerken via de uniforme content-array.

​
Taakverloop

1

Stel de content-array samen

Zet de hoofdtekstinstructie eerst, en voeg alleen image-items toe wanneer je first-frame- of last-frame-sturing nodig hebt.
2

Dien de taak in

Sla de geretourneerde task id op. Als je push delivery wilt, stel dan callback_url in wanneer je de taak aanmaakt.
3

Poll tot de output arriveert

Roep ByteDance Video Query aan totdat de taak is voltooid en er een content.video_url aanwezig is.

​
Bekend wrapper-gedrag

Volcengine en Seedance documenteren deze familie als een asynchrone create-then-query-workflow. CometAPI behoudt hetzelfde taakpatroon, maar geeft je één base URL en één API key.
Tijdens live validatie op 2026-03-12 was deze route bereikbaar, maar gaf nog steeds een server-side JSON-parsefout terug voor een standaard JSON-sample. Behandel de OpenAPI-voorbeelden hier als de praktische wrapper-referentie, en valideer je payload vroeg in de ontwikkeling.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
model
string
vereist

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.

Voorbeeld:

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

​
content
object[]
vereist

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.

Respons

200 - application/json

Task accepted.

​
id
string
vereist

Task id for later polling.