Skip to main content
GET
Sử dụng endpoint này sau khi bạn đã có request_id. Endpoint này cho biết 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

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

Tiếp tục thăm dò cho đến khi status là done

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. Khi status xuất hiện, hãy dùng nó làm điều kiện dừng.
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, vì tài liệu của xAI mô tả 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 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

Billing metadata. cost_in_usd_ticks reports the cost in provider ticks.

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