GET
https://zx1.deepwl.net
/
v1
/
videos
/
{task_id}
Grok 任务查询
curl --request GET \
  --url https://zx1.deepwl.net/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>"
}
'
{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "processing",
  "progress": 42,
  "created_at": 1735689600,
  "completed_at": 0,
  "expires_at": 1735776000,
  "seconds": "6",
  "size": "720P",
  "remixed_from_video_id": "",
  "error": {
    "message": "",
    "code": ""
  },
  "video_url": ""
}

Grok 任务查询

OpenAI 格式查询入口。若任务由 POST /v1/video/create 提交,请使用 查询任务 Grok 系列任务提交后,通过 GET /v1/videos/{task_id} 轮询状态。
  • 接口路径是 GET /v1/videos/{task_id}
  • 任务完成后通常可从 video_urloutput.url 读取结果地址。
  • 如果直接下载 video_url 失败,可回退到 GET /v1/videos/{task_id}/content

方法与路径

GET /v1/videos/{task_id}

请求示例

curl https://zx1.deepwl.net/v1/videos/video_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "processing",
  "progress": 42,
  "created_at": 1735689600,
  "completed_at": 0,
  "expires_at": 1735776000,
  "seconds": "6",
  "size": "720P",
  "remixed_from_video_id": "",
  "error": {
    "message": "",
    "code": ""
  },
  "video_url": ""
}

认证

Authorization: Bearer YOUR_API_KEY

Path Parameters

task_id
string
必填
视频任务 ID。

Response

id
string
任务 ID。
status
string
任务状态。常见值有 processingfailedcompleted
progress
integer
进度百分比。
completed_at
integer
完成时间戳。
expires_at
integer
结果过期时间戳。
seconds
string
输出时长。
size
string
输出清晰度档位。
video_url
string
视频地址。完成时会优先尝试读取这个字段,或兼容读取 output.url
error
object
失败原因对象。

轮询建议

实现会按以下顺序取结果地址:
  1. output.url
  2. video_url
  3. url
  4. detail.url
如果直接下载返回的视频地址失败,再回退请求:
GET /v1/videos/{task_id}/content

相关接口