Przejdź do głównej treści
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"
}
Użyj tego endpointu, aby uruchomić zadanie wideo ByteDance Seedance na podstawie tekstu albo tekstu z obrazami referencyjnymi. Żądanie natychmiast zwraca id zadania, a renderowanie jest kontynuowane asynchronicznie.

​
Wybierz bieżącą ścieżkę modelu

  • Użyj strony Models, aby sprawdzić aktualną dostępność modeli i ich identyfikatory.
  • Użyj doubao-seedance-1-5-pro-251215 jako aktualnego przykładu produkcyjnego dla tej trasy.
  • Ten sam aktualny model może obsługiwać zarówno żądania tylko tekstowe, jak i żądania z prowadzeniem przez obraz za pośrednictwem ujednoliconej tablicy content.

​
Przepływ zadania

1

Zbuduj tablicę content

Najpierw umieść główną instrukcję tekstową, a następnie dodaj elementy obrazu tylko wtedy, gdy potrzebujesz wskazówek dla pierwszej lub ostatniej klatki.
2

Wyślij zadanie

Zapisz zwrócone id zadania. Jeśli chcesz dostarczania push, ustaw callback_url podczas tworzenia zadania.
3

Odpytuj, aż pojawi się wynik

Wywołuj ByteDance Video Query, aż zadanie się zakończy i pojawi się content.video_url.

​
Znane zachowanie wrappera

Volcengine i Seedance dokumentują tę rodzinę jako asynchroniczny przepływ create-then-query. CometAPI zachowuje ten sam wzorzec zadań, ale zapewnia jeden base URL i jeden klucz API.
Podczas walidacji na żywo 2026-03-12 ta trasa była osiągalna, ale nadal zwracała błąd parsowania JSON po stronie serwera dla standardowej próbki JSON. Traktuj przykłady OpenAPI tutaj jako praktyczne odniesienie do wrappera i wcześnie waliduj payload na etapie developmentu.

Autoryzacje

​
Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
​
model
string
wymagane

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.

Przykład:

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

​
content
object[]
wymagane

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.

Odpowiedź

200 - application/json

Task accepted.

​
id
string
wymagane

Task id for later polling.