Grok Imagine Video 1.5 Reference to Video

Name: Grok Imagine Video 1.5 Reference to Video
Author: xAI

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

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

Use in agent Get API key

Base price: $0.64USD / run
Execution: async
Model type: video
Input fields: 5

Try the model

Playground

Open playground

Input

Prompt(string)

Text prompt describing the video. Tag references as <IMAGE_0>, <IMAGE_1>, etc.

Aspect Ratio(string)

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(string)

Resolution of the output video. Allowed values: 480p, 720p.

Duration(integer)

115

Video duration in seconds. Range: 1 to 15.

Image URL or upload(array)

Upload

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 <IMAGE_0>, <IMAGE_1>, etc. Maximum 7 images.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price: $0.64 / run
Billing formula: (params.duration ?? 8) * ((params.resolution ?? "480p") == "720p" ? 0.14 : 0.08) + len(params.reference_image_urls ?? []) * 0.01

Context & modalities

Input: Schema-defined
Output: video

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: xAI
Model ID: xai/grok-imagine-video/1.5/reference-to-video
Execution: async
API: Unified Run API
Endpoint: /v1/run

API README

Grok Imagine Video 1.5 Reference To Video

Grok Imagine Video 1.5 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

Named visual references. Call out each supplied image in the prompt so particular characters, objects, wardrobe, or locations have an explicit role.
Multi-image continuity. Use as many as seven references to coordinate several visual anchors within a newly composed moving scene.
Fresh motion and staging. References guide identity and style without forcing the result to behave like a simple animation of one fixed first frame.
Controlled delivery shape. Duration, resolution, and broad aspect-ratio choices adapt the same visual concept to different channels and shot requirements.

Pricing

Duration	Resolution	Price
1 sec	480p	$0.08
1 sec	720p	$0.14
2 sec	480p	$0.16
2 sec	720p	$0.28
3 sec	480p	$0.24
3 sec	720p	$0.42
4 sec	480p	$0.32
4 sec	720p	$0.56
5 sec	480p	$0.40
5 sec	720p	$0.70
6 sec	480p	$0.48
6 sec	720p	$0.84
7 sec	480p	$0.56
7 sec	720p	$0.98
8 sec	480p	$0.64
8 sec	720p	$1.12
9 sec	480p	$0.72
9 sec	720p	$1.26
10 sec	480p	$0.80
10 sec	720p	$1.40
11 sec	480p	$0.88
11 sec	720p	$1.54
12 sec	480p	$0.96
12 sec	720p	$1.68
13 sec	480p	$1.04
13 sec	720p	$1.82
14 sec	480p	$1.12
14 sec	720p	$1.96
15 sec	480p	$1.20
15 sec	720p	$2.10

Billed per second of requested output duration at xAI list price. Each reference image adds $0.01.

When to Use

Scenario	Why this route fits
Concept development	Choose Grok Imagine Video 1.5 Reference To Video when its reference to video workflow matches the starting material and you need several clearly directed variations.
Production iteration	Use explicit duration, resolution, ratio, seed, or quality controls to compare versions without changing the core creative brief.
Channel adaptation	Generate directly in the landscape, square, portrait, or vertical format required by the destination whenever that control is available.
Automated pipelines	Integrate the asynchronous media URL into review queues, asset libraries, publishing tools, or a later finishing stage.
Alternative route	Pick 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

Property	Details
Model ID	`xai/grok-imagine-video/1.5/reference-to-video`
Required inputs	`prompt`
Execution	Asynchronous; poll the returned generation ID
Output	Downloadable media URL
`prompt`	string; required
`aspect_ratio`	string; optional; choices: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
`resolution`	string; optional; choices: 480p, 720p; default: 480p
`duration`	integer; optional; range: 1–15; default: 8
`reference_image_urls`	array; optional

Related Models

Model	Best for
`xai/grok-tts`	Alternative grok tts workflow
`xai/grok-imagine-video/text-to-video`	Alternative text to video workflow
`xai/grok-imagine-video/extend`	Alternative extend workflow
`xai/grok-imagine-video/image-to-video`	Alternative image to video workflow

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

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

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "xai/grok-imagine-video/1.5/reference-to-video",
  "prompt": "The person from <IMAGE_0> walks through a rainy neon-lit street.",
  "duration": 8,
  "resolution": "480p",
  "reference_image_urls": [
    "https://v3b.fal.media/files/b/0a8b90e0/BFLE9VDlZqsryU-UA3BoD_image_004.png"
  ]
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All language models

Model	Context	Input / 1M	Output / 1M	Released
Grok Imagine Video 1.5 Reference to VideoThis model `xAI`	—	—	—	Aug 1, 2026
Grok Imagine Video 1.5 Text to Video `xAI`	—	—	—	Aug 1, 2026
Grok Imagine Video 1.5 `xAI`	—	—	—	May 31, 2026
Grok Imagine Video Reference to Video `xAI`	—	—	—	Mar 24, 2026
Grok Imagine Video Extend `xAI`	—	—	—	Mar 24, 2026
Grok Imagine Video Edit `xAI`	—	—	—	Jan 29, 2026