选择视频 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,直到任务进入终止状态。
响应示例
成功的创建响应可能如下所示。请在轮询前保存任务 ID:video_url;某些提供商格式使用模型特定的结果字段,或在已记录该路由时使用视频内容路由:
示例模型记录
此示例模型目录响应展示了
/api/models 封装结构以及一个视频模型记录的结构。这并非完整的模型列表。cURL
常见错误
缺少任务 ID
缺少任务 ID
在从任务处理程序返回之前,存储创建响应中的 ID。
轮询过快
轮询过快
在状态检查之间添加延迟和退避。
不支持的时长或尺寸
不支持的时长或尺寸
使用所选视频端点文档中说明的时长和分辨率字段。
缺少 video_url
缺少 video_url
将
video_url 视为可选字段,并在可用时回退到模型专属的结果字段或内容路由。未收到回调
未收到回调
将轮询作为事实依据,并验证你的回调 URL 接受 POST 请求。
错误代码和重试策略
400
400
在修正 Prompt、文件、时长或尺寸字段之前,请勿重试。
401
401
在 API 密钥存在且有效之前,请勿重试。
404
404
重试前检查任务 ID、基础 URL、路径和模型 ID。
413
413
重试前减小上传大小。
429
429
使用指数退避重试,并降低创建或轮询的并发度。
500 或 503
500 或 503
使用退避策略重试任务创建;除非任务进入终态错误,否则继续轮询现有任务。
定价和模型目录
模型页面
了解 CometAPI 如何在文档中公开模型 ID。
模型目录
浏览模型可用性和功能。
定价
调用模型前请查看定价。