Gebruik polling en webhooks voor videogenaratie

Gebruik polling als basis voor videogenaratie, omdat elke async job een task ID retourneert die je kunt opvragen. Voeg webhooks alleen toe wanneer het geselecteerde video-endpoint callback-URL’s ondersteunt, en behoud polling als de bron van waarheid voor gemiste of providerspecifieke callbacklevering.

Maak een videotaak aan

De volgende aanvraag maakt een minimale videotaak aan en slaat de geretourneerde ID op. Voeg velden voor duur, resolutie of callback alleen toe wanneer de pagina van het geselecteerde model die velden documenteert.

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"

De response bevat een task ID en status:

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

Poll de status

De volgende aanvraag controleert de status van de videotaak:

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

De response verandert naarmate de task vordert. Voltooide responses kunnen video_url bevatten wanneer de modeladapter een result-URL heeft; gebruik anders modelspecifieke result-velden of de contentroute /v1/videos/{id}/content wanneer dat model proxied downloads ondersteunt.

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

Ontvang een webhook

CometAPI definieert niet één universele callback-payload voor elk videomodel. Behandel callbacks als providerspecifieke pass-through-events, sla de ruwe body op en stem de uiteindelijke status af met polling. De volgende Express-handler accepteert een videocallback en slaat de event op:

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);

Een callback-payload bevat doorgaans velden voor taskidentiteit en status, maar de exacte nesting hangt af van het geselecteerde model of de provider:

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

Veelvoorkomende fouten

Error	Oplossing
Verloren callback	Poll op task ID totdat je app een eindstatus heeft opgeslagen.
Dubbele callback	Maak callbackafhandeling idempotent op basis van task ID.
Callback geweigerd	Retourneer snel een `2xx`-response en verwerk de job daarna op de achtergrond.
Mismatch in providerspecifieke payload	Sla de ruwe callback-payload op en normaliseer die in je app.
Ontbrekende `video_url`	Behandel `video_url` als optioneel en gebruik polling plus modelspecifieke result-velden of `/v1/videos/{id}/content` wanneer beschikbaar.

Begin hier

Snelstarts voor model-API's

Kernhandleidingen voor de API

Bibliotheken

Fouten

Prijzen en facturering

Ondersteuning

Gebruik polling en webhooks voor videogenaratie

Maak een videotaak aan

Poll de status

Ontvang een webhook

Veelvoorkomende fouten

Gerelateerde links

​Maak een videotaak aan

​Poll de status

​Ontvang een webhook

​Veelvoorkomende fouten

​Gerelateerde links

Maak een videotaak aan

Poll de status

Ontvang een webhook

Veelvoorkomende fouten

Gerelateerde links