GET
https://zx1.deepwl.net
/
v1
/
video
/
query
查询任务
curl --request GET \
  --url https://zx1.deepwl.net/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "grok:05c8e247-7e64-472a-acb1-e7f2de5d0d04",
  "status": "processing",
  "video_url": null,
  "status_update_time": 1762780400,
  "progress": 50
}

​
查询任务

Grok 统一视频任务提交后，通过 GET /v1/video/query 查询进度与结果。查询参数使用 id，值为 创建视频 返回的任务 ID。
  • 路由入口是 GET /v1/video/query。
  • 任务 ID 通过 Query 参数 id 传入，格式常为 grok:...。
  • 完成后 video_url 会带上可访问地址；处理中可能为 null。

​
方法与路径

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

​
请求示例

curl "https://zx1.deepwl.net/v1/video/query?id=grok:48a67431-0708-46d1-9ab9-83cb84700153" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
响应示例

{
  "id": "grok:05c8e247-7e64-472a-acb1-e7f2de5d0d04",
  "status": "processing",
  "video_url": null,
  "status_update_time": 1762780400,
  "progress": 50
}
部分渠道还会返回 asset_id、video_file_id、trace_id 等扩展字段，请以实际响应为准。

​
认证

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

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

​
Response

​
id
string
任务 ID。
​
status
string
任务状态，常见值包括 processing、completed、failed、unknown。
​
video_url
string | null
视频结果地址。任务未完成时可能为 null。
​
status_update_time
integer
状态最近更新时间（Unix 时间戳）。
​
progress
integer
任务进度百分比，部分响应包含。
​
prompt
string
提交时的提示词回显。
​
ratio
string
视频比例回显，例如 3:2。
​
thumbnail_url
string
缩略图地址，完成后可能出现。

​
相关接口