Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Query an xAI video job

Use the request_id from the generation or edit endpoint to poll status until the job completes. xAI documents the final video URL as temporary.

get/grok/v1/videos/{request_id}

Path parameters

request_idstring required

Deferred request id returned by the create or edit endpoint.

Response

Current xAI video task state.

request_idstring

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

modelstring

xAI video model id.

status'queued' | 'processing' | 'done' | 'failed' | 'expired'

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

progressinteger

Completion percentage when returned.