你将构建的内容
你将提交一个 Sora 2 视频任务,存储返回的视频 ID,轮询直到任务完成,并下载最终的视频内容。前提条件
- 存储在
COMETAPI_KEY中的 CometAPI API key - 安装了
requests的 Python 3.10+,或 Node.js 18+ - 用于轮询的服务端 worker 或任务队列
API key、基础 URL、身份验证
使用以下接口创建 Sora 任务:代码示例
使用下方标签页查看可复制的 cURL、Python 和 Node.js 示例。流程说明
Sora 生成是异步的。创建端点会返回一个视频 ID 和初始状态。轮询GET /v1/videos/<video_id>,直到 status 变为 completed 或 failed。当任务完成后,使用 GET /v1/videos/<video_id>/content 下载文件。
请使用精确的 WxH 尺寸。Sora API 参考文档列出了标准的横向和纵向尺寸,以及适用于 Pro model 工作流的更大 Pro 尺寸。
常用参数
故障排查 / 常见问题
创建请求失败
创建请求失败
请使用 multipart form data。参考中的 Sora 创建请求使用表单字段,而不是 JSON 请求体。
内容下载失败
内容下载失败
仅在状态端点返回
completed 后再下载内容。请将完成后的文件存储到你自己的存储中。Pro 尺寸不可用
Pro 尺寸不可用
仅在 Pro model 工作流中使用更大的 Pro 尺寸。首次请求请从
1280x720 开始。后续步骤
- 阅读创建 Sora 2 视频 API 参考。
- 使用获取 Sora 2 视频进行轮询。
- 使用获取 Sora 2 视频内容进行下载。
- 在模型中查找可用的视频模型。
- 查看对视频生成使用轮询和 webhook。
- 通过在调用模型前估算请求成本。