Chuyển đến nội dung chính
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"
    }
  }
}
Sử dụng endpoint này sau khi bạn đã có request_id. Endpoint này cho biết tác vụ xAI còn đang chạy hay không và trả về metadata video cuối cùng khi đã sẵn sàng.

​
Hãy kiểm tra các trường này trước

  • code và message của wrapper để phát hiện lỗi cấp cao nhất
  • data.status cho trạng thái tác vụ CometAPI
  • data.data.status cho trạng thái lồng nhau của nhà cung cấp
  • data.data.video.url khi quá trình render hoàn tất

​
Vòng lặp thăm dò

1

Trước tiên hãy tạo hoặc chỉnh sửa video

Bắt đầu với Video Generation hoặc Video Edit, sau đó sao chép request_id được trả về.
2

Tiếp tục thăm dò cho đến khi trạng thái lồng nhau là done

Kiểm tra cả các trường wrapper và các trường lồng nhau của nhà cung cấp để bạn có thể phân biệt lỗi wrapper với lỗi ở cấp nhà cung cấp.
3

Lưu lại tệp đã hoàn tất

Tải xuống hoặc sao chép video.url cuối cùng ngay khi có thể, vì tài liệu của xAI cho biết các URL được tạo ra là tạm thời.

​
Điều cần biết trên CometAPI

Đây vẫn là cùng một bước thăm dò mà xAI mô tả trong quy trình chính thức của họ. CometAPI thêm một lớp wrapper bao quanh payload của nhà cung cấp để bạn có thể xử lý các tác vụ async nhất quán hơn giữa các nhà cung cấp.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tham số đường dẫn

​
request_id
string
bắt buộc

Deferred request id returned by the create or edit endpoint.

Phản hồi

200 - application/json

Current task state.

​
code
string
bắt buộc
​
message
string
bắt buộc
​
data
object
bắt buộc