跳转到主要内容
GET
/
kyyAiPower
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/sora_abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "processing",
  "video_url": null,
  "error": null
}

Sora 查询视频任务

使用任务 ID 查询 Sora 视频生成任务的状态和结果。

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{key}}

路径参数

id
string
必填
视频生成任务的唯一标识符,从创建任务接口返回

响应参数

id
string
视频生成任务的唯一标识符
object
string
对象类型,固定为 video.generation
created
integer
任务创建时间戳
model
string
使用的模型名称
status
string
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
video_url
string
生成的视频URL,当 status 为 completed 时返回
error
string
错误信息,当 status 为 failed 时返回

状态流程

1

queued

任务已创建并加入队列,等待处理
2

processing

任务正在处理中,Sora 模型正在生成视频
3

completed

任务完成,视频生成成功,可通过 video_url 获取结果

轮询建议

轮询策略:
  • 建议轮询间隔:30-60 秒(视频生成时间较长)
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completedfailed 时停止轮询

视频URL说明

重要提示:
  • 生成的视频URL有效期通常为 24 小时
  • 请及时下载并保存视频到你的存储系统
  • URL 过期后将无法访问视频
  • 视频文件通常为 MP4 格式

生成时间预估

10 秒视频

预计生成时间:2-5 分钟

15 秒视频

预计生成时间:3-8 分钟

25 秒视频

预计生成时间:5-15 分钟(仅 sora-2-pro)
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/sora_abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "processing",
  "video_url": null,
  "error": null
}