创建视频任务
以下请求会创建一个最小化的视频任务,并存储返回的 ID。仅当所选模型页面文档说明了这些字段时,才添加时长、分辨率或回调字段。轮询状态
以下请求会检查视频任务状态:video_url;否则,请使用模型特定的结果字段,或者在该模型支持代理下载时使用 /v1/videos/{id}/content 内容路由。
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
通过存储任务 ID、检查任务状态以及处理回调投递失败,使用轮询和 webhook 跟踪 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;否则,请使用模型特定的结果字段,或者在该模型支持代理下载时使用 /v1/videos/{id}/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 |
|---|---|
| 回调丢失 | 按任务 ID 轮询,直到你的应用已存储终态。 |
| 重复回调 | 通过任务 ID 让回调处理具备幂等性。 |
| 回调被拒绝 | 尽快返回 2xx 响应,然后在后台处理任务。 |
| 提供商特定负载不匹配 | 存储原始回调负载,并在你的应用中将其标准化。 |
缺少 video_url | 将 video_url 视为可选字段,并在可用时结合轮询以及模型特定结果字段或 /v1/videos/{id}/content 使用。 |