generate-image

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