OpenClaudia/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 still gpt-image-1 — pass --model gpt-image-2 (or set up an alias) when you want the flagship.

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-1)

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-1 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