Vai al contenuto principale
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"
}
Usa questo endpoint per avviare un’attività video ByteDance Seedance a partire da testo, oppure da testo più immagini di riferimento. La richiesta restituisce immediatamente un task id e il rendering continua in modo asincrono.

​
Scegli il percorso del modello corrente

  • Usa la pagina Models per verificare la disponibilità e gli identificatori del modello corrente.
  • Usa doubao-seedance-1-5-pro-251215 come esempio di produzione corrente per questa route.
  • Lo stesso modello corrente può gestire sia richieste solo testo sia richieste guidate da immagini tramite l’array content unificato.

​
Flusso dell’attività

1

Crea l'array content

Inserisci prima l’istruzione testuale principale, poi aggiungi elementi immagine solo quando ti serve una guida per il primo frame o per l’ultimo frame.
2

Invia l'attività

Salva il task id restituito. Se vuoi la consegna push, imposta callback_url quando crei l’attività.
3

Interroga finché non arriva l'output

Chiama ByteDance Video Query finché l’attività non termina e non è presente un content.video_url.

​
Comportamento noto del wrapper

Volcengine e Seedance documentano questa famiglia come un flusso di lavoro asincrono create-then-query. CometAPI mantiene lo stesso schema basato su task, ma ti offre un unico URL di base e un’unica API key.
Durante la validazione live del 2026-03-12, questa route era raggiungibile ma restituiva ancora un errore di parsing JSON lato server per un esempio JSON standard. Considera gli esempi OpenAPI qui come riferimento pratico del wrapper e valida il tuo payload nelle prime fasi dello sviluppo.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
model
string
obbligatorio

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.

Esempio:

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

​
content
object[]
obbligatorio

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.

Risposta

200 - application/json

Task accepted.

​
id
string
obbligatorio

Task id for later polling.