Agent Skills › swarmclawai/swarmclaw › openai-image-gen

openai-image-gen

GitHub

通过 OpenAI Images API (GPT Image, DALL-E) 生成图片，支持批量生成、随机提示词采样及 HTML 画廊输出。

skills/openai-image-gen/SKILL.md swarmclawai/swarmclaw

Trigger Scenarios

需要生成图像时使用 OpenAI 图像模型创建视觉内容时

Install

npx skills add swarmclawai/swarmclaw --skill openai-image-gen -g -y

More Options

Use without installing

npx skills use swarmclawai/swarmclaw@openai-image-gen

指定 Agent (Claude Code)

npx skills add swarmclawai/swarmclaw --skill openai-image-gen -a claude-code -g -y

安装 repo 全部 skill

npx skills add swarmclawai/swarmclaw --all -g -y

预览 repo 内 skill

npx skills add swarmclawai/swarmclaw --list

SKILL.md

Frontmatter

{
    "name": "openai-image-gen",
    "metadata": {
        "openclaw": {
            "emoji": "🎨",
            "install": [
                {
                    "id": "python-brew",
                    "bins": [
                        "python3"
                    ],
                    "kind": "brew",
                    "label": "Install Python (brew)",
                    "formula": "python"
                }
            ],
            "requires": {
                "env": [
                    "OPENAI_API_KEY"
                ],
                "bins": [
                    "python3"
                ]
            },
            "primaryEnv": "OPENAI_API_KEY"
        }
    },
    "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."
}

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

python3 {baseDir}/scripts/gen.py

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

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