GET
https://zx1.deepwl.net
/
v1
/
video
/
query
查询任务
curl --request GET \
  --url https://zx1.deepwl.net/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "object": "video",
  "model": "sora-2",
  "status": "pending",
  "progress": "0",
  "created_at": 1762010621,
  "size": "large",
  "status_update_time": 1762010621323,
  "detail": {
    "input": {
      "prompt": "make animate",
      "model": "sora-2",
      "images": [],
      "aspect_ratio": "9:16"
    }
  }
}

​
查询任务

Sora 统一视频任务提交后，通过 GET /v1/video/query 查询进度与结果。查询参数使用 id，值为 创建视频 返回的任务 ID。
  • 路由入口是 GET /v1/video/query。
  • 任务 ID 通过 Query 参数 id 传入，格式常为 sora-2:task_...。
  • 返回结构与 OpenAI VIDEO 格式一致，可能包含 status、progress、detail、video_url 等字段。

​
方法与路径

GET /v1/video/query?id={task_id}

​
请求示例

curl "https://zx1.deepwl.net/v1/video/query?id=sora-2:task_01k74ynm13exf9ha36zz7820hv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
响应示例

{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "object": "video",
  "model": "sora-2",
  "status": "pending",
  "progress": "0",
  "created_at": 1762010621,
  "size": "large",
  "status_update_time": 1762010621323,
  "detail": {
    "input": {
      "prompt": "make animate",
      "model": "sora-2",
      "images": [],
      "aspect_ratio": "9:16"
    }
  }
}
部分渠道在 pending 或 completed 时还会返回更完整的 detail 结构。请以实际响应为准做兼容解析。

​
认证

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
id
string
必填
任务 ID，与创建接口返回的 id 一致。

​
Response

​
id
string
任务 ID。
​
object
string
对象类型，常见为 video。
​
model
string
实际使用的模型名。
​
status
string
任务状态，常见值包括 pending、queued、processing、completed、failed、cancelled。
​
progress
string | integer
任务进度。
​
created_at
integer
创建时间（Unix 时间戳）。
​
size
string
输出规格。
​
detail
object
任务详情，通常包含 input 回显与上游元数据。
​
video_url
string
视频结果地址，完成后出现。
​
status_update_time
integer
状态最近更新时间（Unix 时间戳）。

​
相关接口