Skip to main content
GET
Get Grok video content

When to use

Use this endpoint when you want to proxy the download through your own server, or when accessing the metadata.url link directly is inconvenient.

Preconditions

  • The task status must be completed
  • The task has not expired (see the expires_at field)

Response format

On success it returns a video/mp4 byte stream with HTTP 200. The client should write the response body to a file or stream it to the end user.

Alternative

If you only need the link, just read metadata.url from the GET /v1/videos/{task_id} response — no need to download via this endpoint.

Authorizations

Authorization
string
header
required

Bearer Token authentication, format: Authorization: Bearer sk-xxxxxx. Get an API Key in the console.

Path Parameters

task_id
string
required

The video task ID returned by the create endpoint's id field.

Response

Video content retrieved successfully, returns the raw MP4 byte stream

The raw byte stream of the video file.