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>'
{
  "request_id": "f5f35814-953e-b094-5a2c-4a90014a58cb"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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 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

Tạo hoặc chỉnh sửa video trước

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 hoàn tất

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

Lưu file đã hoàn tất

Tải xuống hoặc sao chép video.url cuối cùng ngay lập tức, vì xAI ghi rõ rằng các URL được tạo ra 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 xAI video task state.

​
request_id
string

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

​
model
string

xAI video model id.

​
usage
object
​
video
object

Generated video metadata. Present when the job has completed.

​
status
enum<string>

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

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

Completion percentage when returned.

​
error

Error details when the job fails.