Retrieve a video

Both retrieval paths use the same task-state model and expose the task status, generation progress, and video result.

GET/v1/video/generations/{id}

GET/v1/videos/{id}

Use the id returned by the create endpoint to retrieve the Grok video task.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Path Parameters

id*string

ID returned when the Grok video task was created.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/video/generations/xai-task-12345"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "xai-task-12345",
    "status": "succeeded",
    "format": "mp4",
    "url": "https://example.com/generated-video.mp4",
    "metadata": null,
    "error": null
  }
}

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`