Utiliser le polling et les webhooks pour la génération de vidéos

Utilisez le polling comme base pour la génération de vidéos, car chaque tâche asynchrone renvoie un ID de tâche que vous pouvez interroger. Ajoutez des webhooks uniquement lorsque l’endpoint vidéo sélectionné prend en charge les URL de callback, et conservez le polling comme source de vérité pour les callbacks manqués ou les livraisons propres au fournisseur.

Créer une tâche vidéo

La requête suivante crée une tâche vidéo minimale et stocke l’ID renvoyé. Ajoutez des champs de durée, de résolution ou de callback uniquement lorsque la page du modèle sélectionné documente ces champs.

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"

La réponse inclut un ID de tâche et un statut :

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

Interroger le statut

La requête suivante vérifie le statut de la tâche vidéo :

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

La réponse évolue à mesure que la tâche progresse. Les réponses terminées peuvent inclure video_url lorsque l’adaptateur de modèle dispose d’une URL de résultat ; sinon, utilisez des champs de résultat spécifiques au modèle ou la route de contenu /v1/videos/{id}/content lorsque ce modèle prend en charge les téléchargements proxifiés.

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

Recevoir un webhook

CometAPI ne définit pas une charge utile de callback universelle pour chaque modèle vidéo. Traitez les callbacks comme des événements pass-through spécifiques au fournisseur, stockez le corps brut et réconciliez l’état final avec le polling. Le gestionnaire Express suivant accepte un callback vidéo et stocke l’événement :

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

Une charge utile de callback inclut généralement des champs d’identité de tâche et de statut, mais l’imbrication exacte dépend du modèle ou du fournisseur sélectionné :

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

Erreurs courantes

Error	Fix
Callback perdu	Interrogez par ID de tâche jusqu’à ce que votre application ait enregistré un état terminal.
Callback dupliqué	Rendez le traitement des callbacks idempotent par ID de tâche.
Callback rejeté	Renvoyez rapidement une réponse `2xx`, puis traitez la tâche en arrière-plan.
Incompatibilité de charge utile spécifique au fournisseur	Stockez la charge utile brute du callback et normalisez-la dans votre application.
`video_url` manquant	Traitez `video_url` comme facultatif et utilisez le polling ainsi que des champs de résultat spécifiques au modèle ou `/v1/videos/{id}/content` lorsque disponible.

Commencez ici

Démarrages rapides de l’API des modèles

Guides de l’API principale

Bibliothèques

Erreurs

Tarification et facturation

Assistance

Utiliser le polling et les webhooks pour la génération de vidéos

Créer une tâche vidéo

Interroger le statut

Recevoir un webhook

Erreurs courantes

Liens connexes

​Créer une tâche vidéo

​Interroger le statut

​Recevoir un webhook

​Erreurs courantes

​Liens connexes

Créer une tâche vidéo

Interroger le statut

Recevoir un webhook

Erreurs courantes

Liens connexes