SandBase is live — $1 in free credits on signupStart free ›
Use in agentxAI models

xAI modelsvideo generation api

xai/grok-imagine-video/reference-to-video

Grok Imagine Video is xAI's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.

Input
Text prompt describing the video to generate. Use @Image1, @Image2, etc. to reference specific images from reference_image_urls in order.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Resolution of the output video. Allowed values: 480p, 720p.
110
Video duration in seconds. Range: 1 to 10.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

One or more reference image URLs to guide the video generation as style and content references. Reference in prompt as @Image1, @Image2, etc. Maximum 7 images.
Idle

Example output — click Run to generate your own

API README

Grok Imagine Video Reference To Video

Grok Imagine Video Reference To Video is a specialized SandBase endpoint built to compose video using multiple images as named visual references. It is most useful when teams need multi-reference continuity for characters, products, wardrobe, and environments, with the route’s inputs defining a repeatable production contract instead of leaving critical delivery choices to an ad-hoc manual workflow.

Use this exact route when its input mode matches the creative asset already in hand: describe the visual or spoken result clearly, set only the controls that support the intended delivery, and keep the subject, action, environment, camera or performance direction internally consistent. The result is returned asynchronously as a downloadable media URL suitable for review, automation, or downstream finishing.

Highlights

  • Ordered @Image references. Address supplied visuals as @Image1, @Image2, and onward so the prompt assigns each person, object, or setting a precise role.
  • Seven-image context window. Coordinate up to seven visual anchors when one shot must combine several characters, products, wardrobe cues, or environmental references.
  • Compact reference-led clips. A 1–10 second range is tuned for focused actions, reveals, and social-ready beats guided by the selected images.
  • 480p and 720p paths. Choose the resolution tier alongside ten aspect ratios to balance economical iteration with sharper delivery output.

Pricing

Each request includes a $0.0020 fixed charge plus the duration-based video rate.

DurationResolutionPrice
1 sec480p$0.0520
1 sec720p$0.0720
2 sec480p$0.1020
2 sec720p$0.1420
3 sec480p$0.1520
3 sec720p$0.2120
4 sec480p$0.2020
4 sec720p$0.2820
5 sec480p$0.2520
5 sec720p$0.3520
6 sec480p$0.3020
6 sec720p$0.4220
7 sec480p$0.3520
7 sec720p$0.4920
8 sec480p$0.4020
8 sec720p$0.5620
9 sec480p$0.4520
9 sec720p$0.6320
10 sec480p$0.5020
10 sec720p$0.7020

When to Use

ScenarioWhy this route fits
Concept developmentChoose Grok Imagine Video Reference To Video when its reference to video workflow matches the starting material and you need several clearly directed variations.
Production iterationUse explicit duration, resolution, ratio, seed, or quality controls to compare versions without changing the core creative brief.
Channel adaptationGenerate directly in the landscape, square, portrait, or vertical format required by the destination whenever that control is available.
Automated pipelinesIntegrate the asynchronous media URL into review queues, asset libraries, publishing tools, or a later finishing stage.
Alternative routePick a related text-, image-, reference-, edit-, or turbo route when the available source media or required degree of control is different.

Prompt Guide

Lead with the main subject or source asset, then describe the intended action or transformation, environment, composition, camera or vocal delivery, lighting and mood. Keep instructions concrete and compatible; use the route’s explicit fields for duration, resolution, ratio, quality, voice, or reproducibility instead of burying those settings in prose.

{
  "prompt": "A cinematic product reveal with deliberate subject motion, coherent lighting, and a slow camera push.",
  "duration": 8,
  "resolution": "480p",
  "aspect_ratio": "21:9",
  "reference_image_urls": [
    "https://example.com/reference-1.jpg"
  ]
}

Technical Specs

PropertyDetails
Model IDxai/grok-imagine-video/reference-to-video
Required inputsprompt
ExecutionAsynchronous; poll the returned generation ID
OutputDownloadable media URL
promptstring; required
durationinteger; optional; range: 1–10; default: 8
resolutionstring; optional; choices: 480p, 720p; default: 480p
aspect_ratiostring; optional; choices: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
reference_image_urlsarray; optional

Related Models

ModelBest for
xai/grok-ttsAlternative grok tts workflow
xai/grok-imagine-video/text-to-videoAlternative text to video workflow
xai/grok-imagine-video/extendAlternative extend workflow
xai/grok-imagine-video/image-to-videoAlternative image to video workflow

Related Models