Choose Auto, TokenLab Verified, or Official for each request, with prices shown up front. See what's new

xAI: Grok Imagine Video

Grok Imagine Video supports creating, editing, and extending short clips. Text, image references, or existing footage can provide the starting point, allowing a motion concept to develop across several production steps.
Compare models
grok-imagine-video
AvailablexAIVideoAsync
Price
From $0.025
Modalities
Video

About Grok Imagine Video

Grok Imagine Video is xAI's original Imagine video model for creating, editing and extending short clips. It accepts text, a starting image, reference images or existing footage, so one concept can move through several production steps. Compared with the 1.5 releases, which take an image as input, this model covers the full set of text, reference, edit and extension jobs.

Where it works well

  • Handles text-to-video, image-to-video and reference-to-video, so the starting material can be words, a still or style references.
  • Can edit existing footage with a text instruction through video-to-video.
  • Video extension continues a clip from where it ended, letting you build longer sequences in steps.
  • Clips run from one to fifteen seconds at 480p or 720p.
  • Seven aspect ratios cover square, landscape and portrait delivery.

When to choose another model

  • Resolution tops out at 720p, so final broadcast work needs upscaling or another model.
  • Clips are short, so longer pieces require extension steps and careful continuity.
  • Motion and physical detail can drift over a long clip, so short shots hold together best.

Getting started

  1. Create API key

    Create a key in Console, then use it with every model on the platform.

  2. Send your first request

    Copy the example for your language and run it against the endpoint.

    Image to videoReference to videoText to videoVideo extensionVideo to videoTokenLab endpoint
    POST/v1/videos/generations
    curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
      -H "Authorization: Bearer sk-xxx" \
      -H "Content-Type: application/json" \
      -d '{
      "aspect_ratio": "16:9",
      "duration": 5,
      "operation": "text-to-video",
      "resolution": "720p",
      "model": "grok-imagine-video",
      "prompt": "Cinematic sunrise over a calm lake with gentle camera motion."
    }'

Parameters

Image to video

ParameterValues and limitsDefaultNotes
aspect_ratio1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9Not providedNot provided
duration1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Not provided1-15s. The omitted-field default is not verified.
imageNot providedNot providedThe current public contract does not specify an input count limit for this field. Do not infer a count from the example request.
image_urlNot providedNot providedThe current public contract does not specify an input count limit for this field. Do not infer a count from the example request.
operationNot providedNot providedNot provided
promptNot providedNot providedNot provided
resolution480p, 720pNot providedNot provided
start_imageNot providedNot providedThe current public contract does not specify an input count limit for this field. Do not infer a count from the example request.

Reference to video

ParameterValues and limitsDefaultNotes
aspect_ratio1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9Not providedNot provided
duration1, 2, 3, 4, 5, 6, 7, 8, 9, 10Not provided1-15s. The omitted-field default is not verified.
image_urlsInputs: ≥ 1, ≤ 7Not providedReference image aliases share a total limit of seven images. Do not add their limits together.
operationNot providedNot providedNot provided
promptNot providedNot providedNot provided
reference_imagesInputs: ≥ 1, ≤ 7Not providedReference image aliases share a total limit of seven images. Do not add their limits together.
resolution480p, 720pNot providedNot provided

Official reference-to-video accepts up to 7 reference images and max duration 10s.

Text to video

ParameterValues and limitsDefaultNotes
aspect_ratio1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9Not providedNot provided
duration1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Not providedStored route declarations specify different defaults. No uniform omitted-field default is guaranteed; set this field explicitly.
operationNot providedNot providedNot provided
promptNot providedNot providedNot provided
resolution480p, 720pNot providedNot provided

Video extension

Output specifications
duration
6, 10
ParameterValues and limitsDefaultNotes
extend_atRequiredNot providedNot providedRequired start time in seconds in the source video. Use task_id from an earlier result for this model. The omitted-field default is not verified.
extend_times6, 106Use the string "6" or "10" for the added duration in seconds. When omitted, the documented default is six added seconds; the gateway sends the priced operation default as a string.
operationNot providedNot providedNot provided
promptNot providedNot providedNot provided
resolution480p, 720pNot providedSet this value to the source video resolution. Extension retains that resolution. The omitted-field default is not verified.
task_idNot providedNot providedNot provided

Video extension takes task_id, prompt, extend_at (required: the second of the source video where the extension starts) and extend_times (6 or 10 added seconds; 6 when left out). Use the task_id of an earlier grok-imagine-video result; a task the extension cannot continue is rejected before any charge. The extension keeps the source video's resolution: set resolution to the source's (480p or 720p) so the charge matches. The duration selector is not used.

Video to video

ParameterValues and limitsDefaultNotes
operationNot providedNot providedNot provided
promptNot providedNot providedNot provided
resolutionNot providedNot providedDo not send resolution for video-to-video. The current Grok video edit builder rejects resolution, duration, aspect_ratio, and source images. Use prompt and one public HTTPS .mp4 video_url for this operation.
video_urlInputs: ≥ 1, ≤ 1Not providedOne public HTTPS .mp4 source video URL is required for video-to-video. The operation edits that video; it does not accept a source-video list.

Video editing uses prompt and a public HTTPS .mp4 video_url; resolution, duration and aspect_ratio are not used for edits.

Use TokenLab create endpoint and follow returned poll_url; if you need a fixed status path, use `/v1/tasks/{id}`.

Pass `image_url` for image-to-video and `reference_images` for reference-to-video.

Video edits reserve the charge for the 8.7 s edit maximum; final billing uses the duration of the returned video.

Pricing

The Verified price applies to Verified, which costs less on most models. The Official price is the model maker's published price and applies to the more reliable Official route. Auto bills the route that completes the request.

  • Image to videoVerified, Official
  • Reference to videoOfficial
  • Text to videoVerified, Official
  • Video extensionVerified
  • Video to videoOfficial

Pricing

per second
Verified price
How pricing works
Official price
How pricing works

Usage & activity

Success rate is the share of requests that completed. Latency is how long a full response takes; P95 means 95% of requests finished within that time.

Usage & availability

Last 24 hours
Requests
Success rate
P95 latency
Total tokens
Model performance
Metrics appear once privacy and data volume thresholds are met.

Data is based on aggregate user requests, excluding status checks.

Open in Console

Open Grok Imagine Video in Console with a prompt ready to edit or send.

Help me create with grok-imagine-video using text-to-video at /v1/videos/generations. Show the result, status, and cost.

Use cases

Best for
  • Text to Video
  • Product teasers

    Animate a hero product still into a short loop, choosing portrait or square framing for social posts.

  • Reference-guided scenes

    Provide character or style images and a prompt, and generate a clip that follows the references without locking the first frame.

  • Edit and extend footage

    Restyle or alter a clip with a text instruction, then extend the final moment into a longer shot.

Prompt examples

A paper boat drifts down a rain-filled gutter, camera low and following, soft grey light, six seconds.

Using the attached character images, show her walking through a night market, handheld camera, neon reflections.

Extend this clip by five seconds: the drone keeps rising and reveals the whole coastline.

FAQ

What can Grok Imagine Video do?

It creates short clips from text, from an image, or from reference images, edits existing video with a text instruction, and extends a clip past its last frame. Duration is one to fifteen seconds.

What resolutions and ratios are available?

Output can be 480p or 720p, in square, 3:2, 2:3, 4:3, 3:4, 16:9 or 9:16. Choose the ratio that matches your destination, such as 9:16 for vertical feeds.

How is it different from grok-imagine-video-1.5?

This model covers text, reference, edit and extension jobs. The 1.5 models take a starting image and animate it. Use this one when you start from words, references or existing footage.

Can it extend a video I already have?

Yes. Extension continues a clip from its final moment, so you can chain several steps to make a longer shot. Check continuity between steps, since motion and detail can drift.

Does it need an input image?

No. Text alone is enough to start. Add an image or references only when you want to fix the look of the opening scene. Leave them out for open-ended ideas.

How much does Grok Imagine Video cost?

Rates depend on the billing unit, specification, and usage. Compare matching conditions in the model's detailed pricing; a single rate does not determine the total cost.

Which endpoint should Grok Imagine Video use?

Use https://api.tokenlab.sh/v1/videos/generations for Grok Imagine Video. The request example below shows the matching code shape.

Which operations does Grok Imagine Video support?

Grok Imagine Video supports Image to video, Reference to video, Text to video, Video extension, Video to video. Select an operation above to see its endpoint and request example.

Compare Grok Imagine Video

Guides that use Grok Imagine Video

Sources

Reviewed Oct 2, 2026

More from Grok Imagine

Related models