Guides

Use your cast in Grok Imagine

xAI. Verified 2026-10-19. Official docs.

Grok Imagine animates a still as the first frame and, on the 1.5 model, also accepts a stack of reference images so the same face, outfit and proportions carry across clips that do not start from the sheet. It is the most flexible of the five for a multi-view pack: pin hero.png as the first frame and hand it the other views as references in the same request.

Which file goes where

Capabilities

Steps

  1. Open grok.com or the Grok app and switch to the Imagine tab (a paid Grok plan is required for video).
  2. Click the image upload control in the composer and add hero.png. The still becomes the first frame and the clip keeps its 2:3 aspect ratio.
  3. If your plan exposes reference images, add closeup.png, three_quarter.png and profile.png as references in the same request so the identity holds when the camera moves off the first frame.
  4. Paste the bible text from character.json, then describe the motion, not the picture: what the character does, where the camera goes, what is said.
  5. Pick duration, resolution and aspect ratio. For a first pass use 720p and a short duration; 1080p is only available for text-to-video and image-to-video, not reference-to-video.
  6. Generate, review for identity drift (eyes, hairline, outfit colours), and regenerate with a stronger bible line for whatever drifted.
  7. To continue the scene, use the extend feature on the finished clip with a continuation prompt instead of starting a fresh image-to-video job.

Prompt template

{{bible}} The first frame shows this exact character; keep the face, hair, skin tone, outfit and proportions unchanged throughout. {{action}} Natural motion, steady camera, cinematic lighting, no new characters. If reference images are attached: the character in <IMAGE_1> and <IMAGE_2> is the same person as in the first frame.

Replace {{bible}} with the bible text from character.json and {{action}} with what the character does in the shot.

Tips

Caveats

API notes

POST https://api.x.ai/v1/videos/generations with model grok-imagine-video or grok-imagine-video-1.5, a prompt, an image object (url, base64 data URI, or a Files API file_id) for the first frame, and optionally a reference_images array of url objects; refer to references in the prompt as <IMAGE_1>, <IMAGE_2> and so on. The call is asynchronous and returns a request_id that you poll until the video URL is ready; the official xAI SDKs can poll for you. Extension is a separate POST to /v1/videos/extensions that takes the finished video and a 2 to 10 second continuation.

Start a series

Other generators: Veo 3.1, Hailuo, Seedance 2.0, Nova Reel.