[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Grok Imagine Video 1.5](https://spiral.ai/integrations/opencode/grok-imagine-video-1-5)

# How to Use Grok Imagine Video 1.5 in opencode

Grok Imagine Video 1.5 makes short scenes with synchronized sound, dialogue, and motion. Use native 1080p for text or image animation, or reference images at 720p to guide characters, products, and locations.

|  |  |
| --- | --- |
| Model | Grok Imagine Video 1.5 |
| Available through | xAI |
| Category | Video |
| Price | $0.104 per second at 480p ($0.182 at 720p, $0.325 at 1080p). Input image: $0.013. Each reference image: $0.013. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Grok Imagine Video 1.5 in opencode

- Use Grok Imagine Video 1.5 to animate the product photo in this project's assets folder into an 8-second 1080p shot. Slowly push the camera toward the product, move a soft reflection across it, and add quiet room ambience.
- Read the game's character brief and use Grok Imagine Video 1.5 to animate the matching concept art for 6 seconds at 1080p. Have the character glance toward the camera and wave, with rustling clothes and distant birds.
- Read this project's trailer outline and use Grok Imagine Video 1.5 to generate its opening landscape shot: 10 seconds at 1080p, a slow aerial approach at dawn, low mist, and wind through trees.
- Use Grok Imagine Video 1.5 with the project's character and workshop reference images to make an 8-second 720p scene. Keep the character behind the workbench and the tools stationary; have the character say, 'Let's make something useful.'
- Read the creative brief and use Grok Imagine Video 1.5 to make three separate 6-second 1080p previews of its opening shot. Keep the action and lighting the same, changing only the camera move: locked shot, slow push-in, then sideways tracking.

## How to set up Grok Imagine Video 1.5 in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Grok Imagine Video 1.5**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "xai",
    "model": "grok-imagine-video-1.5",
    "input": {
      "image": {}
    }
  }'
```

Then paste one of the prompts above: opencode finds Grok Imagine Video 1.5 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Grok Imagine Video 1.5 tools and prices

- [Grok Imagine Video 1.5 · Video Generation](https://spiral.ai/tools/xai/grok-imagine-video-1.5) (xAI): $0.104 per second at 480p ($0.182 at 720p, $0.325 at 1080p). Input image: $0.013. Each reference image: $0.013.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image |  | — | Optional input image for image-to-video generation. If provided, generates video with this image as the first frame. Also accepts `input_reference` for compatibility (same semantics — first frame). |
| prompt |  | — | Prompt for video generation. Required for text-to-video (T2V) and reference-to-video (R2V). Optional for image-to-video (I2V) — when omitted, the model generates a video from the image alone. |
| duration | 1 to 15 | 8 | Video duration in seconds. Range: [1, 15]. Default: 8. Also accepts `seconds` for OpenAI API compatibility. Accepts both number (8) and string ("8") values. |
| keyframes |  | — | Optional mid-video keyframe anchors, strictly between the endpoint pins (`image` as the first frame, `last_frame` as the last). Each entry pins an image to appear literally at its timestamp. Only supported by select video models; at most 4 entries. |
| resolution | 480p, 720p, 1080p | — | Resolution of the generated video. |
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2 | — | Aspect ratio of the generated video. Ignored for image-to-video (first-frame `image` input): the aspect ratio is always derived from the input image. |

## What can you do with Grok Imagine Video 1.5 in opencode?

Turn project artwork and creative briefs into short video assets with motion and sound. A coding agent can read the project's files, write shot prompts, and organize generated clips for editing.

### Animate a product photo

Turn a still product image into an 8-second shot with a slow camera move, moving reflections, and matching ambient sound.

### Draft a dialogue scene

Create a short exchange between two characters, with their lines and background ambience specified in the prompt.

### Plan a film shot

Test a 10-second establishing shot with a specific camera move, lighting direction, and soundscape before committing to production.

### Place a product in a scene

Use separate product and location references to draft a 720p scene. Give each reference a clear role and keep the product stationary.

### Animate an illustrated character

Start with an illustration and request a brief gesture, a camera move, and a short spoken line.

### Create landscape footage

Animate a landscape still with drifting clouds or changing light for a short transition between edited scenes.

### Explore recurring-character stories

Reuse character and location references across separate 720p shots, changing the action while keeping each reference's role clear.

## Overview

- [xAI](https://spiral.ai/providers/xai)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Grok Imagine Video 1.5 in other agents

- [Amp](https://spiral.ai/integrations/amp/grok-imagine-video-1-5)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/grok-imagine-video-1-5)
- [Claude](https://spiral.ai/integrations/claude-desktop/grok-imagine-video-1-5)
- [Claude Code](https://spiral.ai/integrations/claude-code/grok-imagine-video-1-5)
- [Cline](https://spiral.ai/integrations/cline/grok-imagine-video-1-5)
- [Codex](https://spiral.ai/integrations/codex/grok-imagine-video-1-5)
- [Cursor](https://spiral.ai/integrations/cursor/grok-imagine-video-1-5)
- [Devin](https://spiral.ai/integrations/devin/grok-imagine-video-1-5)
- [dots](https://spiral.ai/integrations/dots/grok-imagine-video-1-5)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/grok-imagine-video-1-5)
- [Gemini](https://spiral.ai/integrations/gemini/grok-imagine-video-1-5)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/grok-imagine-video-1-5)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/grok-imagine-video-1-5)
- [goose](https://spiral.ai/integrations/goose/grok-imagine-video-1-5)
- [Grok](https://spiral.ai/integrations/grok/grok-imagine-video-1-5)
- [Grok Build](https://spiral.ai/integrations/grok-build/grok-imagine-video-1-5)
- [Hermes](https://spiral.ai/integrations/hermes/grok-imagine-video-1-5)
- [Instinct](https://spiral.ai/integrations/instinct/grok-imagine-video-1-5)
- [Manus](https://spiral.ai/integrations/manus/grok-imagine-video-1-5)
- [Muse](https://spiral.ai/integrations/muse/grok-imagine-video-1-5)
- [Muse Code](https://spiral.ai/integrations/muse-code/grok-imagine-video-1-5)
- [n8n](https://spiral.ai/integrations/n8n/grok-imagine-video-1-5)
- [Notion](https://spiral.ai/integrations/notion/grok-imagine-video-1-5)
- [OpenClaw](https://spiral.ai/integrations/openclaw/grok-imagine-video-1-5)
- [Perplexity](https://spiral.ai/integrations/perplexity/grok-imagine-video-1-5)
- [Raycast](https://spiral.ai/integrations/raycast/grok-imagine-video-1-5)
- [VS Code](https://spiral.ai/integrations/vscode/grok-imagine-video-1-5)
- [Windsurf](https://spiral.ai/integrations/windsurf/grok-imagine-video-1-5)
- [Zapier](https://spiral.ai/integrations/zapier/grok-imagine-video-1-5)

## More opencode guides

- [Grok Imagine Text to Video](https://spiral.ai/integrations/opencode/grok-imagine-text-to-video)
- [Grok Imagine Video 1.5 Image to Video](https://spiral.ai/integrations/opencode/grok-imagine-video-1-5-image-to-video)
- [Grok Imagine Reference to Video](https://spiral.ai/integrations/opencode/grok-imagine-reference-to-video)
- [Grok Imagine Video 1.5 Reference to Video](https://spiral.ai/integrations/opencode/grok-imagine-video-1-5-reference-to-video)
- [Grok Imagine Image to Video](https://spiral.ai/integrations/opencode/grok-imagine-image-to-video)
- [Grok Imagine Video 1.5 Text to Video](https://spiral.ai/integrations/opencode/grok-imagine-video-1-5-text-to-video)

## Questions about Grok Imagine Video 1.5 in opencode

**Can opencode use Grok Imagine Video 1.5?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Grok Imagine Video 1.5 like any built-in tool.

**How much does Grok Imagine Video 1.5 cost in opencode?**

$0.104 per second at 480p ($0.182 at 720p, $0.325 at 1080p). Input image: $0.013. Each reference image: $0.013. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a xAI account to use Grok Imagine Video 1.5 in opencode?**

No. Spiral runs Grok Imagine Video 1.5 on its own xAI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Grok Imagine Video 1.5 in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while Grok Imagine Video 1.5 runs?**

Grok Imagine Video 1.5 runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.

**What is Grok Imagine Video 1.5 useful for?**

Use it for short scenes that need motion and sound together: product shots, animated stills, dialogue scenes, and visual story drafts. Reference images help specify the people, products, or places in a shot.

**How long can a video be?**

A generated clip can last from 1 to 15 seconds. For a longer story, plan separate shots and edit them together.

**Does Grok Imagine Video 1.5 generate sound?**

Yes. It generates sound effects, ambience, and dialogue alongside the action, so describe the sound you want as part of the shot.

**What should I put in a video prompt?**

Describe the shot, camera movement, lighting, and sound. When animating a still, explain what should happen next, such as steam rising while the camera moves closer.

**How should I handle several reference images?**

Give each reference one clear role and a fixed place in the scene. Keep the cast small and props static, following xAI's guidance for scenes with many references.

