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

选择视频 API

创建 Seedance 视频

创建 Seedance 视频任务。

创建 HappyHorse 视频

创建 HappyHorse 文本生成视频任务。

创建 MiniMax H3 视频

创建 MiniMax H3 文本生成视频或参考图生成视频任务。

创建 Flux 3 视频

创建 Flux 3 文生视频或图生视频任务。

创建 Sora 2 视频

创建 Sora 2 视频任务。

获取 Sora 2 视频

查询 Sora 视频任务。

创建 Veo 3 视频

创建 Veo 视频任务。

创建 Wan 视频

创建 Wan 文本生成视频或图片生成视频任务。

创建 xAI 视频

生成 xAI 视频任务。

创建 Vidu 视频

创建 Vidu 文本生成视频或图片生成视频任务。

创建 Omni 视频(测试版)

创建测试版 Omni 视频任务。

创建 Kling 文本生成视频任务

根据文本 Prompt 生成 Kling 视频。

创建 Runway 图片生成视频任务

根据图片生成 Runway 视频。

创建并轮询视频任务

请使用来自 模型页面模型目录的视频功能模型 ID。以下示例使用 POST /v1/videos 创建视频任务,然后轮询返回的任务 ID,直到任务进入终止状态。
这些示例使用占位符 your-video-model-id。请在运行请求前,将其替换为来自 模型页面模型目录 的可用视频模型 ID。
打开 创建 Seedance 视频检索 Seedance 视频 以使用 API 演练场和端点架构。
通过一个直接请求创建任务:
使用返回的 ID 查询一次任务:

响应示例

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

示例模型记录

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

常见错误

在从任务处理程序返回之前,存储创建响应中的 ID。
在状态检查之间添加延迟和退避。
使用所选视频端点文档中说明的时长和分辨率字段。
video_url 视为可选字段,并在可用时回退到模型专属的结果字段或内容路由。
将轮询作为事实依据,并验证你的回调 URL 接受 POST 请求。

错误代码和重试策略

在修正 Prompt、文件、时长或尺寸字段之前,请勿重试。
在 API 密钥存在且有效之前,请勿重试。
重试前检查任务 ID、基础 URL、路径和模型 ID。
重试前减小上传大小。
使用指数退避重试,并降低创建或轮询的并发度。
使用退避策略重试任务创建;除非任务进入终态错误,否则继续轮询现有任务。

定价和模型目录

模型页面

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

模型目录

浏览模型可用性和功能。

定价

调用模型前请查看定价。
最后修改于 2026年8月14日