Get xAI video results
Use GET /grok/v1/videos/ to poll xAI video generation status and retrieve the final video URL once processing completes.
request_id. It tells you whether the xAI job is still running and returns the final video metadata when ready.
Check these fields first
request_idwhen the task has been accepted but the result is not ready yetstatusfor the xAI job state; keep polling while it ispending, and stop ondone,failed, orexpiredprogressfor completion percentage when it is returnedvideo.urlwhen the render is complete
Polling loop
Create or edit the video first
request_id.Poll until the task reaches a terminal state
request_id, wait a few seconds and poll again. Continue while status is pending; stop on done, failed, or expired.Persist the finished file
video.url promptly, because xAI documents generated URLs as temporary.Authorizations
Use your CometAPI API key as the bearer value.
Path Parameters
The deferred request ID returned by the create or edit endpoint.
Response
The current Grok video task state.
Returned when the request is accepted but result metadata is not ready yet.
The Grok video model ID.
Generated video metadata. Present when the job has completed.
The job state. done means the video metadata is ready.
pending, done, failed, expired Completion percentage when returned.
Additional usage metadata returned when the job is complete. Its contents can vary by model.
Error details when the job fails.