官方 API
获取视频
使用 CometAPI GET /v1/videos/ 获取 Sora 2 视频状态、进度以及时长、尺寸、时间戳和过期时间等元数据。
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}在你启动 Sora 任务后使用此端点。它会返回当前任务状态、已配置的尺寸和时长，以及提供商返回的任何错误。
关注这些字段
status表示生命周期状态progress表示粗略的进度信号error表示提供商拒绝或执行任务失败时的错误信息expires_at表示完成后的过期时间，如果你需要了解临时资源何时失效
轮询直到完成
下载文件
当任务状态为
completed 时，继续前往 获取视频内容。CometAPI 上的响应结构
这一步与 Sora 的轮询工作流高度一致。CometAPI 保持 OpenAI 风格的对象结构，因此你只需极少的转换即可接入状态检查。授权
Bearer token authentication. Use your CometAPI key.
路径参数
Video id returned by the create or remix endpoint.
⌘I
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}