Skip to content

Quick Start

Generate your first video and image in minutes.

Prerequisites

  • ✅ Python 3.8+ installed
  • ✅ Dependencies installed (pip install requests google-auth)
  • ✅ API key obtained (see Authentication)

Choose Your Method

The easiest way to generate media - just type and go!

Generate an Image

/generative image "A beautiful sunset over mountains"

Output: 

🖼️ Generating image...
✅ Image saved: +generated_images/image_20260123_123456.png

Generate a Video

/generative video "Ocean waves crashing on the beach"

Output: 

🎬 Generating video...
✅ Video saved: +generated_videos/video_20260123_123456.mp4

With Options

# Higher quality video
/generative video "A cat walking in a garden" --preset quality

# Different aspect ratio
/generative image "Portrait of a robot" --aspect-ratio 9:16

More Skill Examples

For automation or when not using Claude Code.

Generate an Image

# Set API key
export GOOGLE_API_KEY="AIzaSy..."

# Generate image
python image_gen.py "A futuristic city at sunset"

Output: 

🖼️ Image Generation via Gemini
Model: gemini-3-pro-image-preview
...
✅ Image saved: +generated_images/image_20260123_123456.png

Generate a Video

# Generate video
python video_gen.py "A cat walking in a garden"

Output: 

🎬 Video Generation via Veo API
Mode: text_to_video
Model: veo-3.1-generate-preview
...
✅ Video saved: +generated_videos/video_20260123_123456.mp4

With Options

# Higher quality, longer duration
python video_gen.py "A cat walking in a garden" \
  --model veo-3.1-generate-preview \
  --duration 8 \
  --aspect-ratio 16:9

# Use preset
python video_gen.py "A cat walking" --preset quality

Advanced Usage

💰 Cost Estimation

Before generating, check the cost:

/generative video "prompt" --estimate-cost

python video_gen.py "prompt" --estimate-cost

🎛 Using Presets

Presets provide optimized settings for different use cases:

Preset Use Case Model Duration
quick Fast preview veo-3.1-fast 5s
quality Best quality veo-3.1-generate 8s
extend Video extension veo-2.0 8s
budget Cost saving veo-2.0 5s 
/generative video "A cat walking" --preset quality

python video_gen.py "A cat walking" --preset quality

Common First Issues

"Billing not enabled"

  • Video generation requires billing
  • Free tier only for images (Gemini 2.0 Flash)

"Model not found"

  • Check model name spelling
  • Use /generative info or python check_api.py to list available models

"Rate limit exceeded"

  • Wait a few seconds and retry
  • Consider using --preset budget

Next Steps