Skip to main content

你将构建的内容

你将提交一个 Sora 2 视频任务,存储返回的视频 ID,轮询直到任务完成,并下载最终的视频内容。

前提条件

  • 存储在 COMETAPI_KEY 中的 CometAPI API key
  • 安装了 requests 的 Python 3.10+,或 Node.js 18+
  • 用于轮询的服务端 worker 或任务队列

API key、基础 URL、身份验证

使用以下接口创建 Sora 任务:
使用以下接口轮询状态:
使用以下接口下载已完成的内容:
使用 Bearer token 进行身份验证:

代码示例

使用下方标签页查看可复制的 cURL、Python 和 Node.js 示例。

流程说明

Sora 生成是异步的。创建端点会返回一个视频 ID 和初始状态。轮询 GET /v1/videos/<video_id>,直到 status 变为 completedfailed。当任务完成后,使用 GET /v1/videos/<video_id>/content 下载文件。 请使用精确的 WxH 尺寸。Sora API 参考文档列出了标准的横向和纵向尺寸,以及适用于 Pro model 工作流的更大 Pro 尺寸。

常用参数

故障排查 / 常见问题

请使用 multipart form data。参考中的 Sora 创建请求使用表单字段,而不是 JSON 请求体。
仅在状态端点返回 completed 后再下载内容。请将完成后的文件存储到你自己的存储中。
仅在 Pro model 工作流中使用更大的 Pro 尺寸。首次请求请从 1280x720 开始。

后续步骤