Grok Video API · Beta

Bring short-video generation into a production workflow

Create a dedicated Grok Video API key to submit text-to-video, image-to-video, editing, or extension jobs. Track every asynchronous task with clear specifications and estimates.

Dedicated video API keys
Traceable async tasks
24-hour result retention
Silver bird in motion with temporal echoes
Four workflows, one API family

Keep generation and follow-up creation in one task flow

Video requests do not hold the browser connection open. Save the request_id, poll status, and preview or download the result when it is ready.

01

Text to video

Describe the scene, subject, camera motion, and pacing to create a short video.

02

Image to video

Upload one primary reference image and add motion, camera movement, and time.

03

Edit video

Create a new task from an existing video and an editing instruction.

04

Extend video

Continue from the end of a source video and receive a new request_id.

Models and specifications

Use the model that matches the input

Text generation, editing, and extension use the base model. Image-to-video uses the 1.5 model, and the console prevents unsupported combinations.

ModelBest forResolutionDuration
grok-imagine-videoText, edit, extend480p / 720p115s
grok-imagine-video-1.5Single-image video480p / 720p / 1080p115s
Asynchronous integration

Submit once and track the request_id to completion

Creation endpoints accept the task. Save the returned identifier and query status because there is no upstream task-list API.

1

Create and use a dedicated Grok Video API key for generation, editing, or extension.

2

Save the returned request_id in your own task record.

3

Poll status and preserve the identifier when an unknown status appears.

4

Stream or download the completed result before it expires.

Five core endpoints

Use the /v1 paths. Status and content requests must use the same API key that created the task.

POST/v1/videos/generations
POST/v1/videos/edits
POST/v1/videos/extensions
GET/v1/videos/{request_id}
GET/v1/videos/{request_id}/content
curl https://api.gettoken.dev/v1/videos/generations \
  -H "Authorization: Bearer $GETTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "A quiet city street after rain",
    "resolution": "720p",
    "duration": 8
  }'
Cost and retention

Estimate before submission and trust actual usage afterward

The server quotes model, resolution, and duration before submission. Actual cost appears only when the status result explicitly includes it; otherwise the value remains an estimate.

Users do not select or switch the video pricing group.

24h

Completed results remain available for 24 hours.

HTTP Range support enables streaming and timeline seeking.

Cancellation, deletion, batch generation, and multiple reference images are not available yet.

FAQ

Start with one controlled video task

Choose an existing API key, review the model, resolution, duration, and quote, then complete the first generation in the workspace.