获取 Sora 2 视频

GET

videos

{video_id}

VIDEO_ID="<video_id>"

curl "https://api.cometapi.com/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "id": "<video_id>",
  "model": "sora-2",
  "object": "video",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1781079478
}

在你启动 Sora 任务后，使用此端点。它会返回当前任务状态、配置的尺寸和时长，以及提供方返回的任何错误。

关注这些字段

status：生命周期状态
progress：粗略的进度信号
error：当提供方拒绝任务或任务失败时
expires_at：完成后如果你需要知道临时资源何时过期

轮询直到完成

先创建视频

从创建视频开始。

按 id 轮询

将返回的 id 传入此处，并持续检查，直到任务达到 completed 或 failed。

下载文件

当任务为 completed 时，继续前往获取视频内容。

CometAPI 上的响应结构

这一步与 Sora 的轮询工作流高度一致。CometAPI 保留了 OpenAI 风格的对象结构，因此你可以几乎无需转换就接入状态检查。

授权

Authorization

string

header

必填

Bearer token authentication. Use your CometAPI key.

路径参数

video_id

string

必填

Video id returned by the create or remix endpoint.

响应

200 - application/json

Current job state.

string

必填

Task id.

size

string

必填

model

string

必填

object

string

必填

status

string

必填

Task state: queued, in_progress, completed, or failed.

seconds

string

必填

progress

integer

必填

Render progress from 0 to 100.

created_at

integer

必填

Unix timestamp of task creation.

error

object | null

prompt

string

expires_at

integer | null

completed_at

integer | null

Unix timestamp of completion.

remixed_from_video_id

string | null

video_url

string

Time-limited download URL present when status is completed. Mirror the file to your own storage for long retention.

创建一个 Sora 2 视频

下载 Sora 2 视频内容

VIDEO_ID="<video_id>"

curl "https://api.cometapi.com/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "id": "<video_id>",
  "model": "sora-2",
  "object": "video",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1781079478
}

内容审核

API 密钥

关注这些字段

轮询直到完成

CometAPI 上的响应结构

授权

路径参数

响应

​关注这些字段

​轮询直到完成

​CometAPI 上的响应结构

授权

路径参数

响应

关注这些字段

轮询直到完成

CometAPI 上的响应结构