跳转到主要内容
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}
当你已经拿到 request_id 后，就可以使用此端点。它会告诉你 xAI 任务是否仍在运行，并在就绪时返回最终视频元数据。

​
先检查这些字段

  • 用包装层的 code 和 message 检查顶层错误
  • 查看 data.status 了解 CometAPI 任务状态
  • 查看 data.data.status 了解嵌套的提供商状态
  • 当渲染完成时，查看 data.data.video.url

​
轮询流程

1

先创建或编辑视频

先使用 视频生成 或 视频编辑，然后复制返回的 request_id。
2

持续轮询，直到嵌套状态为 done

同时检查包装层字段和嵌套提供商字段，这样你就能区分包装层失败和提供商级失败。
3

保存已完成的文件

及时下载或复制最终的 video.url，因为 xAI 文档说明生成的 URL 是临时的。

​
在 CometAPI 上你可以预期什么

这仍然是 xAI 在其官方工作流中描述的同一个轮询步骤。CometAPI 在提供商 payload 外增加了一层包装结构，这样你就可以在不同提供商之间更一致地处理异步任务。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路径参数

​
request_id
string
必填

Deferred request id returned by the create or edit endpoint.

响应

200 - application/json

Current task state.

​
code
string
必填
​
message
string
必填
​
data
object
必填