Sora2查询任务

OpenAPI Specification

带上任务 ID 即可查询视频任务生成进度与成片地址；状态字段 status 依次返回 NOT_START、IN_PROGRESS、SUCCESS、FAILURE，分别对应尚未开始、生成中、已完成、已失败。

请求方式：GET

接口地址

text

https://api.allyang.cn/v2/videos/generations/{task_id}

请求头

Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）

路径参数

task_id（string，必填）

返回示例

json

{
  "task_id": "veo3:1756693796-YQVHH4A3Lg",
  "platform": "<提供方>",
  "action": "<动作名>",
  "status": "SUCCESS",
  "fail_reason": "",
  "submit_time": 1756693797,
  "start_time": 1756693808,
  "finish_time": 1756693898,
  "progress": "100%",
  "data": {
    "output": "https://example.com/…"
  },
  "search_item": ""
}

使用提示：轮询间隔建议不低于数秒；失败时请结合返回的 fail_reason 排查。