Generate images using Google Gemini APIs with post-processing options

version
1.0.0

Install

/plugin install gemini-imagen@notque-gemini-imagen

Run it inside Claude Code after adding the marketplace with /plugin marketplace add notque/gemini-imagen.

Contents

Discovered from source

Skills 1

Gemini Imagen

Generate images from text prompts using Google's Gemini APIs. This plugin gives Claude Code the ability to generate images directly.


Quick Start

# Generate an image
python3 ~/.claude/plugins/gemini-imagen/skills/gemini-imagen/scripts/generate_image.py \
  --prompt "A cute cartoon cat" \
  --output cat.png

CRITICAL: Exact Model Names

Use ONLY these exact model strings:

Model StringSpeedBest For
gemini-2.5-flash-imageFast (2-5s)Drafts, iterations
gemini-3-pro-image-previewSlower (5-15s)Quality, text rendering, 2K

Common mistakes:

  • gemini-2.5-flash-preview-05-20 - WRONG (date suffixes are for text models)
  • gemini-2.5-pro-image - WRONG (doesn't exist)
  • gemini-3-flash-image - WRONG (doesn't exist)

Instructions

Step 1: Check API Key

echo "GEMINI_API_KEY is ${GEMINI_API_KEY:+set}"

If not set, tell the user to run /imagen:setup.

Step 2: Install Dependencies

pip install google-genai Pillow

Step 3: Generate Image

python3 ~/.claude/plugins/gemini-imagen/skills/gemini-imagen/scripts/generate_image.py \
  --prompt "YOUR PROMPT HERE" \
  --output /path/to/output.png

Step 4: Verify Output

ls -la /path/to/output.png

Model Selection

Use CaseModelWhy
Iterating on promptsgemini-2.5-flash-imageFast feedback (2-5s)
Final assetgemini-3-pro-image-previewBest quality
Game spritesgemini-2.5-flash-imageMany images, consistent
Text in imagegemini-3-pro-image-previewBetter typography
Batch generationgemini-2.5-flash-imageCost effective

Post-Processing Options

Remove Watermarks (--remove-watermark)

Removes bright pixels from image corners. Very useful for cleaning up generated images.

Background Transparency (--transparent-bg)

Converts solid-color backgrounds to transparent. Great for sprites and icons.

python3 generate_image.py \
  --prompt "Character on gray background" \
  --output char.png \
  --remove-watermark \
  --transparent-bg

Batch Generation

Generate multiple images from a file:

# prompts.txt (one per line)
python3 generate_image.py \
  --batch prompts.txt \
  --output-dir ./images/

Error Handling

ErrorSolution
GEMINI_API_KEY not setRun /imagen:setup
Rate limit (429)Wait 60s, script auto-retries
Content policy (400)Modify prompt
No image in responseAdd more detail to prompt
Pillow not installedRun pip install Pillow

Script Reference

Location: scripts/generate_image.py

ArgumentRequiredDescription
--promptYes*Text prompt
--outputYes*Output file path (.png)
--modelNoModel (default: gemini-3-pro-image-preview)
--remove-watermarkNoRemove corner watermarks
--transparent-bgNoMake background transparent
--bg-colorNoBackground hex color (default: #3a3a3a)
--batchNoPrompts file (one per line)
--output-dirNoDirectory for batch output

*Required unless using --batch

Exit Codes:

  • 0: Success
  • 1: Missing API key
  • 2: Generation failed
  • 3: Invalid arguments

What This Plugin CAN Do

  • Generate images from text prompts
  • Select between fast and quality models
  • Remove watermarks from images
  • Make backgrounds transparent
  • Batch generate multiple images

What This Plugin CANNOT Do

  • Use non-Gemini models (DALL-E, Midjourney, Stable Diffusion)
  • Generate video or audio
  • Bypass content policy restrictions

Commands 2

Gemini Imagen Help

Commands

CommandDescription
/imagenGenerate an image
/imagen:setupSetup API key
/imagen:helpThis help

Models

ModelSpeedUse For
gemini-2.5-flash-image2-5sDrafts, iterations
gemini-3-pro-image-preview5-15sQuality, text

Quick Generate

python3 ~/.claude/plugins/gemini-imagen/skills/gemini-imagen/scripts/generate_image.py \
  --prompt "A cute cartoon cat" \
  --output cat.png

Options

FlagDescription
--promptText prompt
--outputOutput file (.png)
--modelModel selection
--remove-watermarkClean corner watermarks
--transparent-bgTransparent background
--batchPrompts file

Troubleshooting

ErrorFix
API key missing/imagen:setup
Rate limitedWait 60s
No Pillowpip install Pillow

Gemini Imagen Setup

Step 1: Get Your API Key

  1. Go to Google AI Studio
  2. Sign in with Google
  3. Click "Create API Key"
  4. Copy the key

Step 2: Set Environment Variable

macOS / Linux (zsh):

echo 'export GEMINI_API_KEY="your_key_here"' >> ~/.zshrc && source ~/.zshrc

macOS / Linux (bash):

echo 'export GEMINI_API_KEY="your_key_here"' >> ~/.bashrc && source ~/.bashrc

Windows PowerShell:

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your_key_here", "User")
# Restart terminal

Windows CMD:

setx GEMINI_API_KEY "your_key_here"
:: Restart terminal

Step 3: Install Dependencies

pip install google-genai Pillow

Step 4: Verify

echo "GEMINI_API_KEY is ${GEMINI_API_KEY:+set}"

Should output: GEMINI_API_KEY is set

Troubleshooting

Key not found after setting:

  • Restart your terminal
  • Check the correct shell config file (.zshrc vs .bashrc)

Invalid API key error:

  • Verify the key was copied correctly (no extra spaces)
  • Ensure the key is for Gemini API (not Vertex AI)

pip install fails:

  • Try pip3 install google-genai Pillow
  • Or use python3 -m pip install google-genai Pillow

Sponsors

Details

Marketplace
notque/gemini-imagen
Source
.
Author
notque
Category
Development