Skip to main content
通过选择与你的任务类型匹配的提供商工作流,使用 CometAPI 视频模型文档。大多数视频端点都会创建异步任务,因此请保存任务 ID,并使用轮询来获取结果。仅当模型专属页面文档说明支持回调时,再添加回调。

选择视频 API

创建 Seedance 视频

创建 Seedance 视频任务。

创建 HappyHorse 视频

创建 HappyHorse 文生视频任务。

创建 Sora 2 视频

创建 Sora 2 视频任务。

获取 Sora 2 视频

查询 Sora 视频任务。

创建 Veo 3 视频

创建 Veo 视频任务。

创建 Wan 视频

创建 Wan 文生视频任务。

创建 xAI 视频

生成 xAI 视频任务。

创建 Vidu 视频

创建 Vidu 文生视频任务。

创建 Omni 视频(Beta)

创建测试版 Omni 视频任务。

创建 Kling 文生视频任务

根据文本 Prompt 生成 Kling 视频。

创建 Runway 图生视频任务

根据图像生成 Runway 视频。

创建并轮询视频任务

使用 Models 页面模型目录中的支持视频的 model ID。下面的示例先通过 POST /v1/videos 创建一个视频任务,然后持续轮询返回的任务 ID,直到任务进入终态。
这些示例使用占位符 your-video-model-id。在运行请求之前,请将其替换为 Models 页面模型目录中可用的视频 model ID。
打开 创建 Seedance 视频获取 Seedance 视频,以使用 API playground 和端点 schema。

响应示例

成功的创建响应可能如下所示。请在轮询之前先保存任务 ID:
成功的轮询响应可能如下所示。已完成的响应可能包含 video_url;某些提供商格式会使用模型特定的结果字段,或在已记录该路由时使用视频内容路由:

示例模型记录

此示例模型目录响应展示了 /api/models 的响应封装以及一个视频模型记录的结构。它不是完整的模型列表。
cURL

常见错误

在你的作业处理器返回之前,先保存创建响应中的 ID。
在状态检查之间增加延迟和退避。
使用为所选视频端点记录的 duration 和 resolution 字段。
video_url 视为可选,并在可用时回退到模型特定的结果字段或 content 路由。
使用轮询作为事实来源,并验证你的回调 URL 接受 POST 请求。

错误码与重试策略

在修正 prompt、文件、duration 或 size 字段之前,不要重试。
在 API key 存在且有效之前,不要重试。
重试前请检查 task ID、base URL、路径和 model ID。
重试前请减小上传大小。
使用指数退避重试,并降低创建或轮询的并发度。
使用退避重试任务创建;除非任务进入终态错误,否则继续轮询现有任务。

定价与模型目录

Models page

了解 CometAPI 如何在文档中公开 model ID。

Model directory

浏览可用模型及其能力。

Pricing

在调用模型前查看定价。
最后修改于 2026年6月25日