AI Image Generation

Setup

On first use, read setup.md.

When to Use

User needs AI-generated visuals, edits, or consistent image sets. Use this skill to pick the right model, write stronger prompts, and avoid outdated model choices.

Architecture

User preferences persist in ~/image-generation/. See memory-template.md for setup.

~/image-generation/
├── memory.md      # Preferred providers, project context, winning recipes
└── history.md     # Optional generation log

Quick Reference

Topic	File
Initial setup	setup.md
Memory template	memory-template.md
Migration guide	migration.md
Benchmark snapshots	benchmarks-2026.md
Prompt techniques	prompting.md
API handling	api-patterns.md
GPT Image (OpenAI)	gpt-image.md
Gemini and Imagen (Google)	gemini.md
FLUX (Black Forest Labs)	flux.md
Midjourney	midjourney.md
Leonardo	leonardo.md
Ideogram	ideogram.md
Replicate	replicate.md
Stable Diffusion	stable-diffusion.md

Core Rules

1. Resolve aliases to official model IDs first

Community names shift quickly. Before calling an API, map the nickname to the provider model ID.

Community label	Official model ID to try first	Notes
Nano Banana	gemini-2.5-flash-image-preview	Common nickname, not an official Google model ID
Nano Banana 2 / Pro	Verify provider docs	Usually a provider preset over Gemini image models
GPT Image 1.5	gpt-image-1.5	Current OpenAI high-tier image model
GPT Image mini / iMini	gpt-image-1-mini	Budget/faster OpenAI variant
FLUX 2 Pro / Max	flux-pro / flux-ultra	Many platforms rename these SKUs

2. Pick models by task, not by hype

Task	First choice	Backup
Exact text in image	gpt-image-1.5	Ideogram
Multi-turn edits	gemini-2.5-flash-image-preview	flux-kontext-pro
Photoreal hero shots	imagen-4.0-ultra-generate-001	flux-ultra
Fast low-cost drafts	gpt-image-1-mini	imagen-4.0-fast-generate-001
Character/product consistency	flux-kontext-max	gpt-image-1.5 with references
Local no-API workflows	flux-schnell	SDXL

3. Use benchmark tables as dated snapshots

Benchmarks drift weekly. Use benchmarks-2026.md as a starting point, then recheck current rankings when quality is critical.

4. Draft cheap, finish expensive

Start with 1-4 low-cost drafts, pick one, then upscale or rerender only the winner.

5. Keep a fallback chain

If the preferred model is unavailable, fallback by tier:

1. same provider lower tier, 2) cross-provider equivalent, 3) local/open model.

6. Treat DALL-E as legacy

OpenAI lists DALL-E 2/3 as legacy. Do not use them as default for new projects.

Common Traps

• Using vendor nicknames as model IDs -> API errors and wasted retries
• Assuming "Nano Banana Pro" or "FLUX 2" are universal IDs -> provider mismatch
• Copying old DALL-E prompt habits -> weaker output vs modern GPT/Gemini image models
• Comparing text-to-image and image-editing scores as if they were the same benchmark
• Optimizing every draft at max quality -> cost spikes without quality gain

Security & Privacy

Data that leaves your machine:

• Prompt text
• Reference images when editing or style matching

Data that stays local:

• Provider preferences in ~/image-generation/memory.md
• Optional local history file

This skill does NOT:

• Store API keys
• Upload files outside chosen provider requests
• Persist generated images unless user asks to save them

External Endpoints

Provider	Endpoint	Data Sent	Purpose
OpenAI	api.openai.com	Prompt text, optional input images	GPT Image generation/editing
Google Gemini API	generativelanguage.googleapis.com	Prompt text, optional input images	Gemini image generation/editing
Google Vertex AI	aiplatform.googleapis.com	Prompt text, optional input images	Imagen 4 generation
Black Forest Labs	api.bfl.ai	Prompt text, optional input images	FLUX generation/editing
Replicate	api.replicate.com	Prompt text, optional input images	Hosted third-party image models
Midjourney	discord.com	Prompt text	Midjourney generation via Discord workflows
Leonardo	cloud.leonardo.ai	Prompt text, optional input images	Leonardo generation/editing
Ideogram	api.ideogram.ai	Prompt text	Typography-focused image generation

No other data is sent externally.

Migration

If upgrading from a previous version, read migration.md before updating local memory structure.

Trust

This skill may send prompts and reference images to third-party AI providers. Only install if you trust those providers with your content.

Related Skills

Install with clawhub install <slug> if user confirms:

• image-edit - Specialized inpainting, outpainting, and mask workflows
• video-generation - Convert image concepts into video pipelines
• colors - Build palettes for visual consistency across assets
• ffmpeg - Post-process image sequences and exports

Feedback

• If useful: clawhub star image-generation
• Stay updated: clawhub sync