Skip to main content
GET
cURL
Sử dụng endpoint này sau khi bạn đã có request_id. Endpoint này cho biết liệu tác vụ xAI vẫn đang chạy hay không và trả về siêu dữ liệu video cuối cùng khi đã sẵn sàng.

Trước tiên, hãy kiểm tra các trường này

  • request_id khi tác vụ đã được chấp nhận nhưng kết quả chưa sẵn sàng
  • status để biết trạng thái tác vụ xAI; tiếp tục thăm dò khi giá trị là pending, và dừng khi là done, failed hoặc expired
  • progress để biết phần trăm hoàn thành khi giá trị này được trả về
  • 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 bằng Tạo video xAI hoặc Tạo bản chỉnh sửa video xAI, sau đó sao chép request_id.
2

Thăm dò cho đến khi tác vụ đạt trạng thái kết thúc

Nếu phản hồi chỉ lặp lại request_id, hãy đợi vài giây rồi thăm dò lại. Tiếp tục khi statuspending; dừng khi là done, failed hoặc expired.
3

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

Hãy tải xuống hoặc sao chép video.url cuối cùng ngay, vì xAI ghi trong tài liệu rằng các URL được tạo chỉ có hiệu lực tạm thời.

Ủy quyền

Authorization
string
header
bắt buộc

Use your CometAPI API key as the bearer value.

Tham số đường dẫn

request_id
string
bắt buộc

The deferred request ID returned by the create or edit endpoint.

Phản hồi

200 - application/json

The current Grok video task state.

request_id
string

Returned when the request is accepted but result metadata is not ready yet.

model
string

The Grok video model ID.

video
object

Generated video metadata. Present when the job has completed.

status
enum<string>

The job state. done means the video metadata is ready.

Tùy chọn có sẵn:
pending,
done,
failed,
expired
progress
integer

Completion percentage when returned.

usage
object

Additional usage metadata returned when the job is complete. Its contents can vary by model.

error

Error details when the job fails.

Lần sửa đổi cuối 21 tháng 8, 2026