openai-image-gen
Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
When & Why to Use This Skill
This Claude skill automates batch image generation by integrating with the OpenAI Images API, supporting DALL-E 3, DALL-E 2, and specialized GPT image models. It streamlines the creative process by allowing users to generate multiple visual assets simultaneously using structured or randomized prompts, and it automatically organizes outputs into a convenient HTML gallery for rapid review and selection.
Use Cases
- 1. Rapid Design Prototyping: Generate a wide variety of UI placeholders, icons, or conceptual art for web and mobile applications in a single run.
- 2. Marketing & Social Media Campaigns: Produce bulk sets of high-quality images for blog posts, advertisements, or social media content based on specific brand themes.
- 3. Creative Brainstorming: Use the random prompt sampler to explore diverse artistic styles and visual directions during the early stages of a creative project.
- 4. Automated Asset Production: Efficiently create large volumes of images with consistent technical specifications, such as transparent backgrounds, specific aspect ratios, and optimized formats like WebP.
| name | openai-image-gen |
|---|---|
| description | Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery. |
| homepage | https://platform.openai.com/docs/api-reference/images |
| metadata | {"clawdbot":{"emoji":"🖼️","requires":{"bins":["python3"],"env":["OPENAI_API_KEY"]},"primaryEnv":"OPENAI_API_KEY","install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}} |
OpenAI Image Gen
Generate a handful of “random but structured” prompts and render them via the OpenAI Images API.
Run
python3 {baseDir}/scripts/gen.py
open ~/Projects/tmp/openai-image-gen-*/index.html # if ~/Projects/tmp exists; else ./tmp/...
Useful flags:
# GPT image models with various options
python3 {baseDir}/scripts/gen.py --count 16 --model gpt-image-1
python3 {baseDir}/scripts/gen.py --prompt "ultra-detailed studio photo of a lobster astronaut" --count 4
python3 {baseDir}/scripts/gen.py --size 1536x1024 --quality high --out-dir ./out/images
python3 {baseDir}/scripts/gen.py --model gpt-image-1.5 --background transparent --output-format webp
# DALL-E 3 (note: count is automatically limited to 1)
python3 {baseDir}/scripts/gen.py --model dall-e-3 --quality hd --size 1792x1024 --style vivid
python3 {baseDir}/scripts/gen.py --model dall-e-3 --style natural --prompt "serene mountain landscape"
# DALL-E 2
python3 {baseDir}/scripts/gen.py --model dall-e-2 --size 512x512 --count 4
Model-Specific Parameters
Different models support different parameter values. The script automatically selects appropriate defaults based on the model.
Size
- GPT image models (
gpt-image-1,gpt-image-1-mini,gpt-image-1.5):1024x1024,1536x1024(landscape),1024x1536(portrait), orauto- Default:
1024x1024
- Default:
- dall-e-3:
1024x1024,1792x1024, or1024x1792- Default:
1024x1024
- Default:
- dall-e-2:
256x256,512x512, or1024x1024- Default:
1024x1024
- Default:
Quality
- GPT image models:
auto,high,medium, orlow- Default:
high
- Default:
- dall-e-3:
hdorstandard- Default:
standard
- Default:
- dall-e-2:
standardonly- Default:
standard
- Default:
Other Notable Differences
- dall-e-3 only supports generating 1 image at a time (
n=1). The script automatically limits count to 1 when using this model. - GPT image models support additional parameters:
--background:transparent,opaque, orauto(default)--output-format:png(default),jpeg, orwebp- Note:
streamandmoderationare available via API but not yet implemented in this script
- dall-e-3 has a
--styleparameter:vivid(hyper-real, dramatic) ornatural(more natural looking)
Output
*.png,*.jpeg, or*.webpimages (output format depends on model +--output-format)prompts.json(prompt → file mapping)index.html(thumbnail gallery)