xai/grok-imagine-video/1.5/image-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.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runxai/grok-imagine-video/1.5/image-to-videoInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | URL of the input image for video generation. |
prompt | string | Required | Text description of desired changes or motion in the video. · Max length: 4096 |
duration | integer | Optional | Video duration in seconds. · Min: 1 · Max: 15 · Default: 6 |
resolution | string | Optional | Resolution of the output video. · Options: 480p, 720p · Default: "720p" 480p720p |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "xai/grok-imagine-video/1.5/image-to-video",
"image": "https://static.sandbase.ai/examples/xai/grok-imagine-video/1.5/image-to-video/input_image_0.png",
"prompt": "Medieval knight in ornate armor walking through a mystical forest, bioluminescent plants pulsing with light, ancient stone ruins overgrown with glowing vines, over-the-shoulder camera, dark fantasy aesthetic, volumetric fog and Lumen lighting",
"duration": 6,
"resolution": "720p"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Grok Imagine Video 1.5
Grok Imagine Video 1.5 animates a supplied image into a short video while using the prompt to direct subject movement, camera behavior, atmosphere, and scene progression. The reference image establishes the initial identity and composition, reducing the amount of visual setup that must be reconstructed from text alone.
Use it for social clips, concept shots, product motion, character moments, and other sequences that begin from an approved still. Describe how the scene changes over time—not only what is visible—and choose the supported duration and resolution according to the intended review or delivery workflow.
Highlights
- Image-anchored animation. Carries the supplied frame into motion while retaining its recognizable subject and visual direction.
- Fluid scene movement. Generates temporal change for subjects, environment, and camera rather than applying a simple pan-and-zoom effect.
- Prompt-directed cinematography. Uses written action, framing, lens behavior, pacing, and atmosphere to shape the clip.
- Flexible clip planning. Supports variable duration and resolution for drafts, social formats, and polished review assets.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| 1 seconds | 480p | $0.08 |
| 1 seconds | 720p | $0.14 |
| 2 seconds | 480p | $0.16 |
| 2 seconds | 720p | $0.28 |
| 3 seconds | 480p | $0.24 |
| 3 seconds | 720p | $0.42 |
| 4 seconds | 480p | $0.32 |
| 4 seconds | 720p | $0.56 |
| 5 seconds | 480p | $0.40 |
| 5 seconds | 720p | $0.70 |
| 6 seconds | 480p | $0.48 |
| 6 seconds | 720p | $0.84 |
| 7 seconds | 480p | $0.56 |
| 7 seconds | 720p | $0.98 |
| 8 seconds | 480p | $0.64 |
| 8 seconds | 720p | $1.12 |
| 9 seconds | 480p | $0.72 |
| 9 seconds | 720p | $1.26 |
| 10 seconds | 480p | $0.80 |
| 10 seconds | 720p | $1.40 |
| 11 seconds | 480p | $0.88 |
| 11 seconds | 720p | $1.54 |
| 12 seconds | 480p | $0.96 |
| 12 seconds | 720p | $1.68 |
| 13 seconds | 480p | $1.04 |
| 13 seconds | 720p | $1.82 |
| 14 seconds | 480p | $1.12 |
| 14 seconds | 720p | $1.96 |
| 15 seconds | 480p | $1.20 |
| 15 seconds | 720p | $2.10 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs creating a directed video sequence | The goal is a different media task or endpoint |
| The available inputs match the required local schema | Required source media or permissions are unavailable |
| The brief can specify subject, composition, style, and delivery | The result must be deterministic at pixel or sample level |
| The supported formats and controls match final placement | Delivery requires unsupported dimensions, codecs, or duration |
| An asynchronous generated result fits the workflow | A live, frame-synchronous, or real-time response is mandatory |
Prompt Guide
Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.
{
"prompt": "A cinematic, precisely directed scene with clear subject action, camera movement, lighting, and atmosphere",
"image": "https://example.com/reference.jpg",
"duration": 6,
"resolution": "480p"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | xai/grok-imagine-video/1.5/image-to-video |
| Input fields | image (string)<br>prompt (string)<br>duration (integer; 1–15)<br>resolution (string; 480p, 720p) |
| Required input | prompt, image |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
xai/grok-imagine-video/1.5/text-to-videoxai/grok-imagine-video/1.5/reference-to-videoxai/grok-imagine-video/image-to-video