跳转到主要内容
GET
Grok 任务查询

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

方法与路径

请求示例

响应示例

认证

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
如果直接下载返回的视频地址失败,再回退请求:

相关接口