Hopp til hovedinnhold
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"
}
Bruk dette endepunktet for å starte en ByteDance Seedance-videooppgave fra tekst, eller fra tekst pluss referansebilder. Forespørselen returnerer umiddelbart en oppgave-id, og rendringen fortsetter asynkront.

Velg gjeldende model path

  • Bruk Models-siden for gjeldende modelltilgjengelighet og identifikatorer.
  • Bruk doubao-seedance-1-5-pro-251215 som gjeldende produksjonseksempel for denne ruten.
  • Den samme gjeldende modellen kan håndtere både forespørsler med kun tekst og bildeveiledede forespørsler gjennom den samlede content-arrayen.

Oppgaveflyt

1

Bygg content-arrayen

Legg hovedinstruksjonen i tekst først, og legg deretter til bildeelementer bare når du trenger veiledning for første eller siste bilde.
2

Send inn oppgaven

Lagre den returnerte oppgave-id-en. Hvis du vil ha push-levering, setter du callback_url når du oppretter oppgaven.
3

Poll til output kommer

Kall ByteDance Video Query til oppgaven er ferdig og en content.video_url er til stede.

Kjent wrapper-atferd

Volcengine og Seedance dokumenterer denne familien som en asynkron arbeidsflyt med opprettelse-deretter-spørring. CometAPI beholder det samme oppgavemønsteret, men gir deg én base URL og én API key.
Under live-validering 2026-03-12 var denne ruten tilgjengelig, men returnerte fortsatt en JSON-parsefeil på serversiden for et standard JSON-eksempel. Behandle OpenAPI-eksemplene her som den praktiske wrapper-referansen, og valider payload tidlig i utviklingen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json
model
string
påkrevd

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.

Eksempel:

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

content
object[]
påkrevd

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.

Svar

200 - application/json

Task accepted.

id
string
påkrevd

Task id for later polling.