Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Track CometAPI video generation with polling and webhooks by storing task IDs, checking task status, and handling callback delivery failures.
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"
{
"id": "task_example",
"task_id": "task_example",
"object": "video",
"model": "doubao-seedance-2-0",
"status": "queued",
"progress": 0,
"created_at": 1779872000
}
curl https://api.cometapi.com/v1/videos/task_example \
-H "Authorization: Bearer $COMETAPI_KEY"
video_url when the model adapter has a result URL; otherwise use model-specific result fields or the /v1/videos/{id}/content content route when that model supports proxied downloads.
{
"id": "task_example",
"object": "video",
"model": "doubao-seedance-2-0",
"status": "completed",
"progress": 100,
"completed_at": 1779872300,
"video_url": "<generated-video-url>"
}
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);
{
"task_id": "task_example",
"status": "completed",
"progress": 100,
"result": {
"video_url": "https://example.com/result.mp4"
}
}
| Error | Fix |
|---|---|
| Lost callback | Poll by task ID until your app has stored a terminal state. |
| Duplicate callback | Make callback handling idempotent by task ID. |
| Callback rejected | Return a 2xx response quickly, then process the job in the background. |
| Provider-specific payload mismatch | Store the raw callback payload and normalize it in your app. |
Missing video_url | Treat video_url as optional and use polling plus model-specific result fields or /v1/videos/{id}/content when available. |