OpenAI Image Gen

---

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:

{

"openclaw":

{

"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

Note: Image generation can take longer than common exec timeouts (for example 30 seconds).

When invoking this skill via OpenClaw’s exec tool, set a higher timeout to avoid premature termination/retries (e.g., exec timeout=300).

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

- Default: `1024x1024`

- Default: `1024x1024`

- Default: `1024x1024`

Quality

- Default: `high`

- Default: `standard`

- Default: `standard`

Other Notable Differences

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

Output