Skip to main content
GET
/
grok
/
v1
/
videos
/
{request_id}
REQUEST_ID="<request_id>"

curl "https://api.cometapi.com/grok/v1/videos/$REQUEST_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"
{
  "request_id": "<request_id>"
}
Use this endpoint after you already have a 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_id when the task has been accepted but the result is not ready yet
  • status for the xAI job state; keep polling until it reaches done
  • progress for completion percentage when it is returned
  • video.url when the render is complete

​
Polling loop

1

Create or edit the video first

Start with Create an xAI video or Create an xAI video edit, then copy the returned request_id.
2

Keep polling until status is done

If the response only echoes request_id, wait a few seconds and poll again. Once status appears, use it as the stop condition.
3

Persist the finished file

Download or copy the final video.url promptly, because xAI documents generated URLs as temporary.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
request_id
string
required

Deferred request id returned by the create or edit endpoint.

Response

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.

Available options:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.