---
title: "Query an xAI video job"
method: GET
path: "/grok/v1/videos/{request_id}"
---

# Query an xAI video job

`GET /grok/v1/videos/{request_id}`

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.

## Path parameters

- `request_id` string, required

## Response `200`

Current xAI video task state.

- object
  - `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.
    - `cost_in_usd_ticks` integer — Billing usage value returned by xAI.
  - `video` object — Generated video metadata. Present when the job has completed.
    - `url` string — Temporary URL for the generated MP4.
    - `duration` integer — Video duration in seconds.
    - `respect_moderation` boolean — Moderation flag returned with the video.
  - `status` 'queued' | 'processing' | 'done' | 'failed' | 'expired' — xAI job state. `done` means the video metadata is ready.
  - `progress` integer — Completion percentage when returned.
  - `error` union — Error details when the job fails.
    - string
    - object

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)