generate-image

name	generate-image
description	Generate images using AI (OpenAI GPT Image or Stability AI). Use when the user asks to generate an image, create an AI image, make an illustration, or produce artwork from a text prompt.
argument-hint	["prompt description"]
allowed-tools	Bash(*), Read, Write

AI Image Generation

Generate images from text prompts using OpenAI GPT Image (gpt-image-2 / gpt-image-1 / variants) or Stability AI (SD 3.5 Large).

Tool Location

• Script: ~/.agents/tools/generate-image.py
• Env file: ~/.agents/tools/.env (contains OPENAI_API_KEY and STABILITY_API_KEY)

Available OpenAI image models (verified live via /v1/models 2026-05-15)

Model ID	Notes
gpt-image-2	Flagship. Released 2026-04-21. Best prompt adherence, best photorealism. Default when image quality matters.
gpt-image-2-2026-04-21	Pinned dated variant of gpt-image-2
gpt-image-1.5	Intermediate release between 1 and 2
gpt-image-1-mini	Smaller/cheaper gpt-image-1 variant — use for batch/draft generation where cost matters
gpt-image-1	Original gpt-image. Still works; superseded by gpt-image-2.
chatgpt-image-latest	Always-current alias of the model ChatGPT.com uses (currently gpt-image-2-class). Use when you want "whatever ChatGPT uses today"
dall-e-3	Legacy fallback. Different quality semantics (standard/hd, not low/medium/high).

Pass any of these to --model. The script branches on gpt-image* for the quality/format handling, so all gpt-image-* variants work out of the box.

Default in the script is now gpt-image-2 (the flagship) — pass --model gpt-image-1-mini for cheap batch/draft work.

Quick Usage

Generate with OpenAI gpt-image-2 (flagship)

python ~/.agents/tools/generate-image.py \
  --prompt "a sunset over mountains, oil painting style" \
  --output ./sunset.png \
  --model gpt-image-2 \
  --quality high

Generate with default (gpt-image-2)

python ~/.agents/tools/generate-image.py \
  --prompt "a sunset over mountains, oil painting style" \
  --output ./sunset.png

High quality

python ~/.agents/tools/generate-image.py \
  --prompt "modern logo design for a tech company" \
  --output ./logo.png \
  --size 1024x1024 \
  --quality high

Wide format (good for blog covers, banners)

python ~/.agents/tools/generate-image.py \
  --prompt "abstract digital art with blue tones" \
  --output ./banner.png \
  --size 1536x1024

Tall format (good for mobile, stories)

python ~/.agents/tools/generate-image.py \
  --prompt "portrait of a futuristic city" \
  --output ./city.png \
  --size 1024x1536

Transparent background (icons, logos)

python ~/.agents/tools/generate-image.py \
  --prompt "a minimalist cat icon, flat design" \
  --output ./icon.png \
  --background transparent

Generate with Stability AI (SD 3.5 Large)

python ~/.agents/tools/generate-image.py \
  --prompt "watercolor painting of a garden" \
  --output ./garden.png \
  --provider stability

CLI Options

Option	Description
--prompt, -p	(Required) Text prompt describing the desired image
--output, -o	(Required) Output file path
--provider	openai (default) or stability
--size	Image size for OpenAI: 1024x1024 (default), 1536x1024 (wide), 1024x1536 (tall)
--quality	OpenAI quality: low, medium (default), or high
--background	OpenAI background: auto (default), transparent, or opaque
--model	Override model (default: gpt-image-2 for OpenAI, sd3.5-large for Stability)

Provider Comparison

Feature	OpenAI gpt-image-2	OpenAI gpt-image-1	Stability AI SD 3.5
Released	2026-04-21	2025	—
Prompt adherence	Best	Excellent	Good
Size options	1024x1024, 1536x1024, 1024x1536	1024x1024, 1536x1024, 1024x1536	1024x1024
Quality options	low, medium, high	low, medium, high	N/A
Transparent bg	Yes	Yes	No
Style	Photorealistic + artistic	Photorealistic + artistic	Artistic + photorealistic
Cost per image (high)	Higher than 1	Baseline	N/A

Dependencies

• requests (for API calls)

Install if needed:

pip install requests

Output

The script prints:

• The provider and model used
• The prompt (and revised prompt if applicable)
• The saved file path