Skip to main content
GET
Get Grok video task status

​
Task status

​
Polling advice

Grok video tasks usually finish within tens of seconds to a few minutes, depending on resolution and duration (720p is slower than 480p). Poll every 5–10 seconds and set a reasonable timeout.

​
Getting the video

Once complete, there are two ways to retrieve the video:
  • Use the link in metadata.url directly (it expires — see expires_at — so download promptly)
  • Call GET /v1/videos/{task_id}/content to download through the API proxy

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

Task status retrieved successfully

Grok video task object, compatible with the OpenAI / Sora video task format.

​
id
string
required

Video task ID.

Example:

"video_abc123"

​
object
enum<string>
required

Object type, always video.

Available options:
video
Example:

"video"

​
model
enum<string>
required

The model used to run the task.

Available options:
grok-imagine-video-480p,
grok-imagine-video-720p,
grok-imagine-video-1.5-preview-480p,
grok-imagine-video-1.5-preview-720p
Example:

"grok-imagine-video-720p"

​
status
enum<string>
required

Task status.

Available options:
queued,
in_progress,
completed,
failed
Example:

"queued"

​
progress
integer
required

Task progress percentage (0–100).

Required range: 0 <= x <= 100
Example:

0

​
created_at
integer<int64>
required

Task creation timestamp (milliseconds).

Example:

1764347090922

​
seconds
string
required

Video duration in seconds.

Example:

"10"

​
completed_at
integer<int64>

Task completion timestamp (milliseconds), filled once complete.

Example:

1764347170000

​
expires_at
integer<int64>

Expiration timestamp (milliseconds) of the task and the video file.

Example:

1764433570000

​
size
string

Actual output size, e.g. 1280x720. The actual resolution comes from the model-name suffix; the aspect ratio comes from the request size.

Example:

"1280x720"

​
error
object

Grok video task error info.

​
metadata
object

Extra metadata; usually contains a url field once complete.