| name | generative-media |
| description | Generate and edit images using AI models including Nano Banana 2 (Gemini 3.1 Flash), FLUX.2 Pro, and FLUX.2 Flex via OpenRouter. Covers text-to-image generation, image editing, batch variations, and post-processing. Use when the user asks to generate an image, create artwork, make a picture, edit a photo, create illustrations, generate variations, make a banner, create social media graphics, or any visual content creation task. Triggers: 'generate an image', 'create a picture', 'make an illustration', 'edit this image', 'image variations', 'create artwork', 'banner', 'thumbnail', 'social media graphic', 'hero image', 'product shot'. For logo-specific work, prefer the logo-creator skill. |
Generative Media
Generate and edit images using AI models via OpenRouter. Supports multiple models with shared prompting knowledge and dedicated per-model scripts.
Setup
All scripts use uv run with inline deps — no install needed.
export OPENROUTER_API_KEY="your-key-here"
All script paths below are relative to this skill's directory. Run as:
uv run --with requests python3 scripts/SCRIPT.py COMMAND [args]
Model Selection
| Need | Model | Why |
|---|
| Edit existing image | Nano Banana | Only model with editing |
| Text in image | Nano Banana | Best text rendering |
| 2K/4K resolution | Nano Banana | Only model with size tiers |
| Artistic/illustration | FLUX.2 Pro | Strongest creative styles |
| Fast cheap exploration | FLUX.2 Flex | $0.02/img, 2-5s |
| Default / general | Nano Banana | Most versatile |
Full comparison: references/models/index.md
Workflow
1. Understand the Request
Clarify with the user:
- What: Subject, scene, or concept
- Style: Photo, illustration, painting, flat vector, etc.
- Where it goes: Social media, hero banner, print, icon (determines aspect ratio + resolution)
- Edit or new: Generating from scratch or modifying an existing image?
- Reference: Any images or styles they like?
2. Choose Model
Use the model selection table above. When unsure, default to Nano Banana.
3. Craft the Prompt
Build the prompt using this structure:
[Subject] + [Style] + [Composition] + [Lighting/Color] + [Constraints]
Key differences by model:
- Nano Banana 2: Natural language, conversational prompts. "Create a cozy scene with..."
- FLUX: Keyword-driven, comma-separated descriptors. "cozy cafe, warm lighting, 35mm film..."
Full prompting guide: references/prompting.md
Quick prompt examples:
Product shot:
Minimalist ceramic vase with dried eucalyptus, product photography, soft studio lighting, white background, centered, no text
Social media graphic:
Abstract geometric pattern with navy (#1a2332) and coral (#ff6b6b) shapes, modern minimalist style, 1:1 square composition, clean edges
Hero banner:
Aerial view of a winding mountain road through autumn forest, golden hour lighting, cinematic wide shot, warm color palette, 16:9
4. Generate
Single image:
OPENROUTER_API_KEY="..." uv run --with requests python3 scripts/nano_banana.py generate \
--prompt "YOUR PROMPT" --output-dir ./output --aspect-ratio 16:9 --size 2K --prefix hero
Batch variations (for exploration):
OPENROUTER_API_KEY="..." uv run --with requests python3 scripts/nano_banana.py batch \
--prompt "YOUR PROMPT" --output-dir ./output --count 6 --prefix explore
Edit existing image:
OPENROUTER_API_KEY="..." uv run --with requests python3 scripts/nano_banana.py edit \
--prompt "EDIT INSTRUCTIONS" --input source.png --output-dir ./output --prefix edited
FLUX generation:
OPENROUTER_API_KEY="..." uv run --with requests python3 scripts/flux.py batch \
--prompt "YOUR PROMPT" --output-dir ./output --model pro --count 4
5. Review & Iterate
Build a preview gallery to compare results:
uv run --with Pillow python3 scripts/preview_gallery.py \
--input-dir ./output --title "Project Name"
Open preview.html in browser. Ask user which to keep, iterate, or discard.
Iteration tips:
- Keep what works, describe what to change
- Add constraints to remove unwanted elements: "no text, no watermarks"
- Try a different model if current one struggles with the style
- Use
--prefix v2 for iteration rounds
6. Post-Processing (if needed)
For post-processing (background removal, format conversion, SVG vectorization): references/techniques/upscaling.md
Script Reference
| Script | Purpose | Key Commands |
|---|
nano_banana.py | Gemini 3.1 Flash generation + editing | generate, edit, batch |
flux.py | FLUX.2 Pro/Flex generation | generate, batch |
preview_gallery.py | HTML comparison gallery | --input-dir, --title |
utils.py | Shared utilities | (imported by other scripts) |
Model-Specific Guides
