Grok Imagine Video — Development skill for Claude Code

Grok Imagine Video & Image

[](https://github.com/DevvGwardo/grok-imagine-video) [](LICENSE)

A Python client and [OpenClaw](https://docs.openclaw.ai) skill for generating images and videos using [xAI's Grok Imagine APIs](https://docs.x.ai/developers/model-capabilities).

Features

• Text-to-Image — Generate images from text (up to 10 variations)
• Image Editing — Edit images with natural language instructions
• Text-to-Video — Generate video clips from text descriptions
• Image-to-Video — Animate static images into motion video
• Video Editing — Apply filters, speed changes, color grading, and effects
• Async Polling — Non-blocking job management with progress callbacks
• OpenClaw Integration — Drop-in skill for Discord, Telegram, and WhatsApp bots

Quick Start

1. **Get an API key** at [console.x.ai](https://console.x.ai/)

2. **Set your key**

   export XAI_API_KEY="your-key-here"

3. **Run it**

   from scripts.grok_video_api import GrokImagineVideoClient
   
   client = GrokImagineVideoClient(api_key="your-key")
   
   # Generate a video
   result = client.text_to_video("A golden retriever running through a sunny meadow", duration=10)
   final = client.wait_for_completion(result["request_id"])
   client.download_video(final, "output.mp4")

Usage

Image Generation

result = client.generate_image(
    prompt="A collage of London landmarks in a stenciled street-art style",
    n=4,                       # 1-10 variations
    aspect_ratio="16:9",
    response_format="b64_json" # or "url" (default)
)

Image Editing

result = client.edit_image(
    image_url="https://example.com/photo.jpg",
    prompt="Change the sky to a dramatic sunset"
)

Text-to-Video

result = client.text_to_vi