Files
openclaw/skills/openai-image-gen/SKILL.md
Vincent Koc 04e103d10e fix(terminal): stabilize skills table width across Terminal.app and iTerm (#42849)
* Terminal: measure grapheme display width

* Tests: cover grapheme terminal width

* Terminal: wrap table cells by grapheme width

* Tests: cover emoji table alignment

* Terminal: refine table wrapping and width handling

* Terminal: stop shrinking CLI tables by one column

* Skills: use Terminal-safe emoji in list output

* Changelog: note terminal skills table fixes

* Skills: normalize emoji presentation across outputs

* Terminal: consume unsupported escape bytes in tables
2026-03-11 09:13:10 -04:00

3.3 KiB
Raw Blame History

name, description, homepage, metadata
name description homepage metadata
openai-image-gen Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery. https://platform.openai.com/docs/api-reference/images
openclaw
emoji requires primaryEnv install
🎨
bins env
python3
OPENAI_API_KEY
OPENAI_API_KEY
id kind formula bins label
python-brew brew python
python3
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 OpenClaws 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

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