# Grok Imagine

Grok Imagine generates video clips from text and images with motion, generated audio, and lip-sync through Vercel AI Gateway.

- **Model ID:** `spacexai/grok-imagine-video`
- **Type:** video
- **Providers:** xai
- **Context window:** Not applicable
- **Maximum output tokens:** 0
- **Pricing:** See the provider details below
- **Canonical page:** https://vercel.com/ai-gateway/models/grok-imagine-video

## Supported parameters

- **Parameters:** `aspectRatio`, `resolution`, `duration`, `fps`
- **Operations:** `text-to-video`, `image-to-video`, `video-editing`, `video-extension`
- **Input modalities:** `text`, `image`, `video`
- **Output modalities:** `video`
- **Aspect ratios:** `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`
- **Resolutions:** `480p`, `720p`
- **Durations:** `1s`, `2s`, `3s`, `4s`, `5s`, `6s`, `7s`, `8s`, `9s`, `10s`, `11s`, `12s`, `13s`, `14s`, `15s`
- **Frame rates:** `24 fps`
- **Maximum outputs per request:** Not reported
- **Maximum input images:** 5
- **Input image formats:** `jpg`, `jpeg`, `png`, `webp`, `gif`, `avif`
- **Maximum input image size:** Not reported

## Example

```ts
import { experimental_generateVideo as generateVideo } from 'ai';

const result = await generateVideo({
  model: 'spacexai/grok-imagine-video',
  prompt: 'A serene mountain lake at sunrise.'
});
```

## About

Grok Imagine is SpaceXAI's video generation model, released January 28, 2026 and available through Vercel AI Gateway. It generates video clips from text descriptions and static images with motion, instruction following, and support for complex prompts and follow-up instructions to refine scenes.

The model supports three primary generation modes: text-to-video (creating clips from text descriptions), image-to-video (generating motion from static images), and video editing (modifying existing video content through style changes, object replacement, and scene alterations). It also generates audio timed to the video with lip-sync, so you can skip separate voice recording for many workflows. Grok Imagine produces short clips quickly enough for iterative creative workflows. You can call it from the AI SDK's generateVideo function or the v0 Grok Creative Studio. Video generation is currently available to Pro and Enterprise plan subscribers and paid AI Gateway users.

## What to consider

Video generation is currently limited to Pro and Enterprise plans, as well as paid AI Gateway users. Verify your plan supports video generation before integrating.

Grok Imagine understands follow-up instructions to tweak scenes. Use iterative prompting to refine output rather than trying to get the perfect result in a single generation.

## When to use

### Best For

- **Marketing and social media video content** where custom clips are needed at scale without traditional video production
- **Product demos and explainer videos** that visualize concepts, features, or workflows through generated scenes
- **Creative prototyping and storyboarding** where teams iterate on visual concepts before committing to full production
- **Content creation pipelines** that generate short video assets programmatically for personalization or A/B testing
- **Lip-synced video with native audio** for talking-head content, presentations, or character-driven narratives

### Consider Alternatives When

- **Static image generation** where Grok Imagine Image or Grok Imagine Image Pro handles the task without video overhead
- **Long-form video production** where traditional editing tools provide more control over extended content
- **Free-tier usage** as video generation currently requires a paid plan

## Best for

- **Marketing and social media video content** where custom clips are needed at scale without traditional video production
- **Product demos and explainer videos** that visualize concepts, features, or workflows through generated scenes
- **Creative prototyping and storyboarding:** teams iterate on visual concepts before committing to full production
- **Content creation pipelines** that generate short video assets programmatically for personalization or A/B testing
- **Lip-synced video with native audio** for talking-head content, presentations, or character-driven narratives

## Consider alternatives

- **Static image generation:** Grok Imagine Image or Grok Imagine Image Pro handles the task without video overhead
- **Long-form video production:** traditional editing tools provide more control over extended content
- **Free-tier usage:** video generation currently requires a paid plan

## Frequently asked questions

### What generation modes does Grok Imagine support?

Three modes: text-to-video (creating clips from descriptions), image-to-video (animating static images), and video editing (modifying existing videos through style changes, object replacement, and scene alterations).

### Does Grok Imagine generate audio?

Yes. Grok Imagine generates audio in the clip with lip-sync, so you often don't need separate voice recording or dubbing.

### How fast does Grok Imagine generate video?

Generation is fast enough for iteration in most setups; exact time depends on length, resolution, and load. Expect short clips, not long renders.

### What plans support video generation?

Pro and Enterprise plan subscribers and paid AI Gateway users.

### How do I authenticate with Grok Imagine through Vercel AI Gateway?

Use your Vercel AI Gateway API key with `spacexai/grok-imagine-video` as the model identifier. You can integrate through the AI SDK's generateVideo function or the v0 Grok Creative Studio.

### Can I refine generated videos with follow-up prompts?

Yes. Grok Imagine understands follow-up instructions to tweak scenes, adjust styles, and modify content. Use iterative prompting to refine output.

### Does Vercel AI Gateway support Zero Data Retention for Grok Imagine?

Zero Data Retention is not currently available for this model. Zero Data Retention is offered on a per-provider basis. See https://vercel.com/docs/ai-gateway/capabilities/zdr for details.

## Links

- [Model page](https://vercel.com/ai-gateway/models/grok-imagine-video)
- [AI Gateway documentation](https://vercel.com/docs/ai-gateway)
- [Provider model documentation](https://docs.x.ai/developers/model-capabilities/video/generation)
- [Provider pricing](https://docs.x.ai/developers/models/grok-imagine-video)