Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
task ID の保存、task status の確認、callback 配信失敗への対応により、polling と webhooks で CometAPI の動画生成を追跡します。
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 が含まれることがあります。それ以外の場合は、model 固有の結果フィールド、またはその model がプロキシ経由のダウンロードをサポートしている場合は /v1/videos/{id}/content の content ルートを使用してください。
{
"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 |
|---|---|
| callback の消失 | アプリが終端状態を保存するまで、task ID で poll してください。 |
| callback の重複 | task ID に基づいて callback 処理を冪等にしてください。 |
| callback が拒否される | すぐに 2xx レスポンスを返し、その後バックグラウンドでジョブを処理してください。 |
| provider 固有 payload の不一致 | 生の callback payload を保存し、アプリ内で正規化してください。 |
video_url がない | video_url は省略可能として扱い、利用可能な場合は polling と model 固有の結果フィールド、または /v1/videos/{id}/content を使用してください。 |