Skip to main content
将轮询作为视频生成的基础方案,因为每个异步任务都会返回一个可供查询的任务 ID。只有当所选视频端点支持回调 URL 时才添加 webhook,并继续将轮询作为漏发回调或提供商特定回调投递情况下的事实来源。

创建视频任务

以下请求会创建一个最小化的视频任务,并存储返回的 ID。仅当所选模型页面文档说明了这些字段时,才添加时长、分辨率或回调字段。
响应中包含任务 ID 和状态:

轮询状态

以下请求会检查视频任务状态:
响应会随着任务推进而变化。完成后的响应在模型适配器提供结果 URL 时可以包含 video_url;否则,请使用模型特定的结果字段,或者在该模型支持代理下载时使用 /v1/videos/{id}/content 内容路由。

接收 webhook

CometAPI 并未为每一种视频模型定义统一的回调负载。应将回调视为提供商特定的透传事件,存储原始请求体,并通过轮询核对最终状态。 以下 Express 处理程序会接收视频回调并存储事件:
回调负载通常包含任务标识和状态字段,但具体嵌套结构取决于所选模型或提供商:

常见错误

相关链接

最后修改于 2026年6月25日