openai-image-gen

name	openai-image-gen
description	Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery. Ideal for rapid prototyping, generating placeholder assets, testing AI art variations across models (GPT-Image, DALL-E 3/2), and building local thumbnail galleries with customizable resolution, quality, and output formats.
version	1.0.0
author	DunCrew
homepage	https://platform.openai.com/docs/api-reference/images
tags	["image-generation","openai","automation","multimedia","cli-tool"]
keywords	["generate images","openai images api","dall-e 3","gpt image","batch image generation","ai art gallery","prompt sampling"]
dangerLevel	safe
inputs	[{"name":"count","type":"integer","description":"Number of images to generate (auto-limited to 1 for DALL-E 3)"},{"name":"model","type":"string","description":"Target generation model (e.g., gpt-image-1, dall-e-3, dall-e-2)"},{"name":"prompt","type":"string","description":"Text prompt for image generation (uses random sampler if omitted)"},{"name":"size","type":"string","description":"Image resolution (e.g., 1024x1024, 1536x1024, auto)"},{"name":"quality","type":"string","description":"Generation quality level (e.g., high, standard, hd, auto)"},{"name":"output_format","type":"string","description":"Output file format (png, jpeg, webp)"},{"name":"background","type":"string","description":"Background type for GPT image models (transparent, opaque, auto)"},{"name":"style","type":"string","description":"Artistic style for DALL-E 3 (vivid, natural)"},{"name":"out_dir","type":"string","description":"Custom output directory for generated files"}]
metadata	{"openclaw":{"emoji":"🖼️","primaryEnv":"OPENAI_API_KEY","requires":{"bins":["python3"],"env":["OPENAI_API_KEY"]},"install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}}
enabled	false

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), or auto
  • Default: 1024x1024
• dall-e-3: 1024x1024, 1792x1024, or 1024x1792
  • Default: 1024x1024
• dall-e-2: 256x256, 512x512, or 1024x1024
  • Default: 1024x1024

Quality

• GPT image models: auto, high, medium, or low
  • Default: high
• dall-e-3: hd or standard
  • Default: standard
• dall-e-2: standard only
  • Default: standard

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, or auto (default)
  • --output-format: png (default), jpeg, or webp
  • Note: stream and moderation are available via API but not yet implemented in this script
• dall-e-3 has a --style parameter: vivid (hyper-real, dramatic) or natural (more natural looking)

Output

• *.png, *.jpeg, or *.webp images (output format depends on model + --output-format)
• prompts.json (prompt → file mapping)
• index.html (thumbnail gallery)