---

name: grok-imagine

description: Generate images and videos via xAI Grok Imagine API. Text-to-image, image-to-video, text-to-video.

homepage: https://docs.x.ai/docs/guides/image-generations

metadata:

{

"openclaw":

{

"emoji": "🎬",

"requires": { "bins": ["python3", "curl"], "env": ["XAI_API_KEY"] },

"primaryEnv": "XAI_API_KEY",

},

}

---

Grok Imagine

Generate images and videos via xAI's Grok Imagine API.

Setup

1. Get API key from [console.x.ai](https://console.x.ai)

2. Save to `~/.config/xai/api_key` or set `XAI_API_KEY` env var

3. Free: $25 on signup + $150/mo with data sharing enabled

Quick Use

Generate Image

python3 {baseDir}/scripts/imagine.py image "a futuristic city at sunset, cyberpunk style"

Generate Video (text-to-video)

python3 {baseDir}/scripts/imagine.py video "a drone flying through a neon-lit city at night, smooth tracking shot"

Animate Image (image-to-video)

python3 {baseDir}/scripts/imagine.py animate ./input.png "slow camera push-in, clouds drifting"

Options

# Image generation
python3 {baseDir}/scripts/imagine.py image "prompt" --size 1024x1024 --out ./output.png

# Video generation (10 sec max, 720p)
python3 {baseDir}/scripts/imagine.py video "prompt" --duration 10 --out ./output.mp4

# Animate existing image
python3 {baseDir}/scripts/imagine.py animate ./image.png "motion description" --duration 8

Output

• Images: PNG format
• Videos: MP4 format, up to 10 seconds, 720p with audio
• Default output directory: `~/Projects/tmp/grok-imagine-{timestamp}/`

Pricing (xAI API)

• Images: ~$0.04 per generation
• Videos: ~$0.40 per generation ($4.20/min with audio)

Models

• `grok-imagine-image` — image generation and editing
• `grok-imagine-video` — video generation (text-to-video, image-to-video)

Tips

• Write prompts like a director: subject + action + setting + camera + lighting + mood
• For video, use motion verbs: "slow dolly forward", "smooth pan right", "handheld sway"
• Iterate in small steps: change one variable at a time