选择视频 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,直到任务进入终态。
响应示例
成功的创建响应可能如下所示。请在轮询之前先保存任务 ID:video_url;某些提供商格式会使用模型特定的结果字段,或在已记录该路由时使用视频内容路由:
示例模型记录
此示例模型目录响应展示了
/api/models 的响应封装以及一个视频模型记录的结构。它不是完整的模型列表。cURL
常见错误
Missing task ID
Missing task ID
在你的作业处理器返回之前,先保存创建响应中的 ID。
Polling too fast
Polling too fast
在状态检查之间增加延迟和退避。
Unsupported duration or size
Unsupported duration or size
使用为所选视频端点记录的 duration 和 resolution 字段。
Missing video_url
Missing video_url
将
video_url 视为可选,并在可用时回退到模型特定的结果字段或 content 路由。Callback not received
Callback not received
使用轮询作为事实来源,并验证你的回调 URL 接受 POST 请求。
错误码与重试策略
400
400
在修正 prompt、文件、duration 或 size 字段之前,不要重试。
401
401
在 API key 存在且有效之前,不要重试。
404
404
重试前请检查 task ID、base URL、路径和 model ID。
413
413
重试前请减小上传大小。
429
429
使用指数退避重试,并降低创建或轮询的并发度。
500 or 503
500 or 503
使用退避重试任务创建;除非任务进入终态错误,否则继续轮询现有任务。
定价与模型目录
Models page
了解 CometAPI 如何在文档中公开 model ID。
Model directory
浏览可用模型及其能力。
Pricing
在调用模型前查看定价。