Zum Hauptinhalt springen
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
}
Verwenden Sie diesen Endpoint, nachdem Sie eine ByteDance Jimeng-Aufgabe erstellt haben. Er startet kein Rendering. Er meldet nur den aktuellen Aufgabenstatus und, wenn der Job abgeschlossen ist, die generierte Video-URL und Ausgabe-Metadaten.

Achten Sie auf diese Felder

  • status für den aktuellen Provider-Status
  • content.video_url, wenn das Rendering abgeschlossen ist
  • resolution, duration, ratio und framespersecond, falls Ihre Anwendung Ausgabe-Metadaten benötigt

Polling-Schleife

1

Erstellen Sie zuerst eine Aufgabe

Beginnen Sie mit ByteDance Video Generation.
2

Per task id abfragen

Rufen Sie diesen Endpoint weiter auf, bis der Status einen Endzustand erreicht.
3

Ergebnis speichern

Wenn content.video_url erscheint, kopieren Sie das Ergebnis in Ihren eigenen Speicher, falls Sie eine langfristige Aufbewahrung benötigen.

Ergebnis-URLs

Der ByteDance-Workflow bleibt weiterhin: zuerst erstellen, dann per task id abfragen. CometAPI behält diese Struktur bei und vereinheitlicht die Authentifizierung. Behandeln Sie die zurückgegebene Video-URL als Bereitstellungs-URL, nicht als dauerhaften Speicher.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Pfadparameter

id
string
erforderlich

Task id returned by the create endpoint.

Antwort

200 - application/json

Current task state.

id
string
erforderlich
model
string
erforderlich
status
string
erforderlich

Provider task status.

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