xai/grok-imagine-video/image-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.
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/image-to-videoInput Schema
5 parameters · 2 required · 3 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 |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
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/image-to-video",
"image": "https://static.sandbase.ai/examples/xai/grok-imagine-video/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 Image To Video
Grok Imagine Video Image To Video is a specialized SandBase endpoint built to animate a still image into a directed video sequence. It is most useful when teams need source-image continuity with explicit motion and camera direction, 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
- Source-frame continuity. The input image anchors subject appearance, palette, and composition while the prompt focuses the model on believable motion.
- Directed camera language. Describe pans, pushes, handheld movement, locked shots, or subject-relative motion to turn a still into a purposeful sequence.
- Flexible shot length. Generate between 1 and 15 seconds so a motion idea can be tested quickly or allowed to unfold as a complete beat.
- Placement-ready framing. Aspect-ratio and resolution controls support landscape, square, portrait, and vertical destinations without relying on a later crop.
Pricing
Each request includes a $0.0020 fixed charge plus the duration-based video rate.
| Duration | Resolution | Price |
|---|---|---|
| 1 sec | 480p | $0.0520 |
| 1 sec | 720p | $0.0720 |
| 2 sec | 480p | $0.1020 |
| 2 sec | 720p | $0.1420 |
| 3 sec | 480p | $0.1520 |
| 3 sec | 720p | $0.2120 |
| 4 sec | 480p | $0.2020 |
| 4 sec | 720p | $0.2820 |
| 5 sec | 480p | $0.2520 |
| 5 sec | 720p | $0.3520 |
| 6 sec | 480p | $0.3020 |
| 6 sec | 720p | $0.4220 |
| 7 sec | 480p | $0.3520 |
| 7 sec | 720p | $0.4920 |
| 8 sec | 480p | $0.4020 |
| 8 sec | 720p | $0.5620 |
| 9 sec | 480p | $0.4520 |
| 9 sec | 720p | $0.6320 |
| 10 sec | 480p | $0.5020 |
| 10 sec | 720p | $0.7020 |
| 11 sec | 480p | $0.5520 |
| 11 sec | 720p | $0.7720 |
| 12 sec | 480p | $0.6020 |
| 12 sec | 720p | $0.8420 |
| 13 sec | 480p | $0.6520 |
| 13 sec | 720p | $0.9120 |
| 14 sec | 480p | $0.7020 |
| 14 sec | 720p | $0.9820 |
| 15 sec | 480p | $0.7520 |
| 15 sec | 720p | $1.0520 |
When to Use
| Scenario | Why this route fits |
|---|---|
| Concept development | Choose Grok Imagine Video Image To Video when its image 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.",
"image": "https://example.com/input.jpg",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "21:9"
}
Technical Specs
| Property | Details |
|---|---|
| Model ID | xai/grok-imagine-video/image-to-video |
| Required inputs | prompt, image |
| Execution | Asynchronous; poll the returned generation ID |
| Output | Downloadable media URL |
image | string; required |
prompt | string; required |
duration | integer; optional; range: 1–15; default: 6 |
resolution | string; optional; choices: 480p, 720p; default: 720p |
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 |
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/reference-to-video | Alternative reference to video workflow |