mouadja02 OpenAI Image Gen
Attribution: Sourced from steipete/agent-scripts by Peter Steinberger.
When to Use
- Generating images via OpenAI Images API (gpt-image-1)
- Running batch image generation with auto-generated HTML gallery
- Comparing prompt variations side by side
Generate images via OpenAI Images API with batch support and an auto-generated HTML gallery.
Setup
- Requires
OPENAI_API_KEYenvironment variable. - Requires Python 3 and the
openaipackage.
Usage
# Basic run (generates random structured prompts)
python3 gen.py
# Custom count
python3 gen.py --count 16
# Custom model
python3 gen.py --model gpt-image-1.5
# Custom prompt
python3 gen.py --prompt "ultra-detailed studio photo of a lobster astronaut" --count 4
# Custom size and quality
python3 gen.py --size 1536x1024 --quality high --out-dir ./out/images
Output
*.pngimages in the output directoryprompts.json(prompt ↔ file mapping)index.html(thumbnail gallery for quick review)
# Open gallery
open ~/tmp/openai-image-gen-*/index.html
Common Options
| Flag | Description |
|---|---|
--count N |
Number of images to generate |
--model MODEL |
Model to use (e.g., gpt-image-1, gpt-image-1.5) |
--prompt TEXT |
Custom prompt (overrides random generation) |
--size WxH |
Image size (e.g., 1024x1024, 1536x1024) |
--quality LEVEL |
Quality level (standard, high) |
--out-dir PATH |
Output directory |