Lấy Kết Quả Tạo Video

Sử dụng GET /grok/v1/videos/ để thăm dò trạng thái tạo video của xAI và lấy URL video cuối cùng khi quá trình xử lý hoàn tất.

GET /grok/v1/videos/{request_id}

Query an xAI video job

cURL

curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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 bạn biết liệu tác vụ xAI vẫ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 cho các 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 provider lồng nhau
• 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 cấp cao nhất và các trường provider lồng nhau để bạn có thể phân biệt lỗi cấp cao nhất với lỗi ở cấp provider.

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ì xAI ghi nhận rằng các URL được tạo là tạm thời.

Ủ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

Show child attributes