Przejdź do głównej treści
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
Użyj tego endpointu po utworzeniu zadania ByteDance Jimeng. Nie uruchamia on renderowania. Jedynie raportuje bieżący stan zadania oraz, gdy zadanie się zakończy, URL wygenerowanego wideo i metadane wyjściowe.

Zwróć uwagę na te pola

  • status dla bieżącego stanu po stronie dostawcy
  • content.video_url, gdy renderowanie zostanie zakończone
  • resolution, duration, ratio i framespersecond, jeśli Twoja aplikacja potrzebuje metadanych wyjściowych

Pętla odpytywania

1

Najpierw utwórz zadanie

2

Odpytuj po task id

Wywołuj ten endpoint, aż status osiągnie stan końcowy.
3

Zapisz wynik

Gdy pojawi się content.video_url, skopiuj wynik do własnego storage, jeśli potrzebujesz długiego okresu przechowywania.

URL-e wyników

W ByteDance workflow nadal najpierw tworzy się zadanie, a potem odpytuje po task id. CometAPI zachowuje tę strukturę i normalizuje uwierzytelnianie. Traktuj zwrócony URL wideo jako URL dostarczenia, a nie trwały storage.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Parametry ścieżki

id
string
wymagane

Task id returned by the create endpoint.

Odpowiedź

200 - application/json

Current task state.

id
string
wymagane
model
string
wymagane
status
string
wymagane

Provider task status.

created_at
integer
wymagane
updated_at
integer
wymagane
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer