# Openai Image Gen

Generate images via OpenAI Images API (GPT Image, DALL-E 3, DALL-E 2).

- Repository: https://github.com/swarmclawai/swarmclaw (703 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-06-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add swarmclawai/swarmclaw --skill openai-image-gen -g -a claude-code -y`
Codex: `npx skills add swarmclawai/swarmclaw --skill openai-image-gen -g -a codex -y`
Cursor: `npx skills add swarmclawai/swarmclaw --skill openai-image-gen -g -a cursor -y`
Gemini CLI: `npx skills add swarmclawai/swarmclaw --skill openai-image-gen -g -a gemini-cli -y`

## Description

Generate images via OpenAI Images API (GPT Image, DALL-E 3, DALL-E 2). Supports batch generation with random prompt sampler and HTML gallery output. Use when asked to generate images with OpenAI and an OPENAI_API_KEY is available.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OpenAI Image Gen

Generate images via the OpenAI Images API with an HTML gallery viewer.

## Run

Note: Image generation can take longer than typical timeouts. Set a higher timeout when running via shell (e.g., 300 seconds).

```bash
python3 {baseDir}/scripts/gen.py
```

## Useful Flags

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

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

### Other Parameters

- **GPT image models** support `--background` (`transparent`, `opaque`, `auto`) and `--output-format` (`png`, `jpeg`, `webp`)
- **dall-e-3** supports `--style` (`vivid` for hyper-real, `natural` for more natural looking)
- **dall-e-3** only supports `n=1`; the script automatically limits count to 1

## Output

The rest: https://github.com/swarmclawai/swarmclaw/blob/HEAD/skills/openai-image-gen/SKILL.md