Polling und Webhooks für die Videogenerierung verwenden

Verwenden Sie Polling als Grundlage für die Videogenerierung, da jeder asynchrone Job eine task ID zurückgibt, die Sie abfragen können. Fügen Sie Webhooks nur hinzu, wenn der ausgewählte Video-Endpoint Callback-URLs unterstützt, und behalten Sie Polling als maßgebliche Quelle für verpasste oder anbieterspezifische Callback-Zustellungen bei.

Einen Video-Task erstellen

Die folgende Anfrage erstellt einen minimalen Video-Task und speichert die zurückgegebene ID. Fügen Sie Felder für duration, resolution oder callback nur hinzu, wenn die Seite des ausgewählten Modells diese Felder dokumentiert.

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=doubao-seedance-2-0" \
  -F "prompt=A cinematic shot of a paper airplane crossing a desk"

Die Antwort enthält eine task ID und einen Status:

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}

Status abfragen

Die folgende Anfrage prüft den Status des Video-Tasks:

curl https://api.cometapi.com/v1/videos/task_example \
  -H "Authorization: Bearer $COMETAPI_KEY"

Die Antwort ändert sich, während der Task fortschreitet. Abgeschlossene Antworten können video_url enthalten, wenn der Modell-Adapter eine Ergebnis-URL hat; andernfalls verwenden Sie modellspezifische Ergebnisfelder oder die Content-Route /v1/videos/{id}/content, wenn dieses Modell Proxy-Downloads unterstützt.

{
  "id": "task_example",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "<generated-video-url>"
}

Einen Webhook empfangen

CometAPI definiert kein universelles Callback-Payload für jedes Videomodell. Behandeln Sie Callbacks als anbieterspezifische Pass-through-Ereignisse, speichern Sie den Rohtext des Bodys und gleichen Sie den Endstatus mit Polling ab. Der folgende Express-Handler akzeptiert einen Video-Callback und speichert das Ereignis:

import express from "express";

const app = express();
app.use(express.json({ limit: "2mb" }));

app.post("/cometapi/video-webhook", async (request, response) => {
  const event = request.body;

  console.log("Task ID:", event.task_id || event.id);
  console.log("Status:", event.status);

  response.status(200).json({ received: true });
});

app.listen(3000);

Ein Callback-Payload enthält üblicherweise Felder zur Task-Identität und zum Status, aber die genaue Verschachtelung hängt vom ausgewählten Modell oder Anbieter ab:

{
  "task_id": "task_example",
  "status": "completed",
  "progress": 100,
  "result": {
    "video_url": "https://example.com/result.mp4"
  }
}

Häufige Fehler

Error	Fix
Verlorener Callback	Führen Sie Polling per task ID durch, bis Ihre App einen Endzustand gespeichert hat.
Doppelter Callback	Gestalten Sie die Callback-Verarbeitung per task ID idempotent.
Callback abgelehnt	Geben Sie schnell eine `2xx`-Antwort zurück und verarbeiten Sie den Job dann im Hintergrund.
Anbieterspezifische Payload stimmt nicht überein	Speichern Sie das rohe Callback-Payload und normalisieren Sie es in Ihrer App.
Fehlende `video_url`	Behandeln Sie `video_url` als optional und verwenden Sie Polling sowie modellspezifische Ergebnisfelder oder `/v1/videos/{id}/content`, wenn verfügbar.

Hier starten

Schnellstarts für Modell-APIs

Core API-Anleitungen

Bibliotheken

Fehler

Preise und Abrechnung

Support

Polling und Webhooks für die Videogenerierung verwenden

Einen Video-Task erstellen

Status abfragen

Einen Webhook empfangen

Häufige Fehler

Verwandte Links

​Einen Video-Task erstellen

​Status abfragen

​Einen Webhook empfangen

​Häufige Fehler

​Verwandte Links

Einen Video-Task erstellen

Status abfragen

Einen Webhook empfangen

Häufige Fehler

Verwandte Links