Skip to main content
GET
Grok 任务查询

Grok 任务查询

Grok Imagine 系列任务提交后,通过 GET /v1/videos/{task_id} 轮询状态,并共用同一组查询与下载接口。
  • 接口路径是 GET /v1/videos/{task_id}
  • 任务完成后,优先从响应中的视频 URL 字段读取结果地址。
  • 如果响应没有公开 URL,或直接下载公开 URL 失败,可回退到 GET /v1/videos/{task_id}/content
  • /content 端点需要携带同一个 Authorization: Bearer YOUR_API_KEY

方法与路径

请求示例

响应示例

认证

Path Parameters

string
required
视频任务 ID。

Response

string
任务 ID。
string
任务状态。常见值有 processingfailedcompleted
string
任务对应的模型名。该字段用于展示和排查,不应用作任务 ID。
integer
进度百分比。
integer
完成时间戳。
integer
结果过期时间戳。
string
输出时长。
string
输出清晰度档位。
string
视频地址。完成时通常可直接下载;如果为空或不可下载,按下方兼容顺序读取其他字段,或回退到 /content
object
失败原因对象。

轮询建议

建议客户端将以下状态视为处理中并继续轮询:queuedpendingprocessingin_progressrunninggenerating 建议将以下状态视为完成:completedsucceededsuccess 建议将以下状态视为失败或终止:failedfailerrorcancelledcanceledexpireddeleted 任务完成后,结果地址可按以下兼容顺序读取:
  1. content.video_url
  2. content.url
  3. output.url
  4. video_url
  5. url
  6. detail.url
  7. data[0].url
如果这些字段都为空,或下载返回的地址失败,再回退请求:
下载 /content 时需要继续携带鉴权头:

相关接口