Generate images and videos using xAI Grok Imagine Extended. Text-to-image, image editing, text-to-video, image-to-video. Use when: user asks to generate, create, or draw an image, or create/animate a video. NOT for: image analysis/understanding (use the image tool instead). Triggers: generate image, create image, draw, grok imagine, make a picture, text to image, generate video, animate, text to video.
Generate images and videos from text prompts using the xAI API.
python3 {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png"
With options:
python3 {baseDir}/scripts/generate_image.py --prompt "a cyberpunk city at night" --filename "city.png" --resolution 2k --aspect-ratio 16:9
Single source image:
python3 {baseDir}/scripts/generate_image.py --prompt "make it a watercolor painting" --filename "edited.png" -i "/path/to/source.jpg"
Multiple source images (up to 3):
python3 {baseDir}/scripts/generate_image.py --prompt "combine into one scene" --filename "combined.png" -i img1.png -i img2.png
Text-to-video:
python3 {baseDir}/scripts/generate_image.py --prompt "a cat walking through flowers" --filename "cat.mp4" --video --duration 5
Image-to-video (animate a still):
python3 {baseDir}/scripts/generate_image.py --prompt "add gentle camera zoom and wind" --filename "animated.mp4" --video -i photo.jpg --duration 5
| Model | Type | Cost |
|---|---|---|
grok-imagine-image | Image (default) | $0.02/img |
grok-imagine-image-pro | Image (high quality) | $0.07/img |
grok-imagine-video | Video (auto for --video) | $0.05/sec |
Select model with --model grok-imagine-image-pro. Video mode always uses grok-imagine-video.
| Flag | Description |
|---|---|
--prompt, -p | Text description (required) |
--filename, -f | Output path (required) |
-i | Input image for editing/animation (repeatable, max 3 for images, 1 for video) |
--model, -m | Image model (default: grok-imagine-image) |
--aspect-ratio, -a | 1:1, 16:9, 9:16, 4:3, 3:4, etc. |
--resolution, -r | Image: 1k/2k. Video: 480p/720p |
--n | Number of images 1-10 (default 1) |
--video | Generate video instead of image |
--duration, -d | Video duration 1-15 seconds (default 5) |
--api-key, -k | Override XAI_API_KEY |
XAI_API_KEY env varskills."grok-imagine".apiKey / skills."grok-imagine".env.XAI_API_KEY in ~/.openclaw/openclaw.json~/keys.txt2026-03-01-cyberpunk-city.pngMEDIA: line for OpenClaw to auto-attach on supported chat providers