用途
OpenAI Image Gen 用于通过 OpenAI Images API 批量生成图片。它会先生成一批“随机但结构化”的提示词,再将这些提示词提交给 OpenAI 图像接口进行渲染,最终产出一组图片及配套的浏览页面。
主要能力
- 批量生成图片:一次运行可生成多张图片。
- 随机提示词采样:自动生成“随机但结构化”的提示词。
- 自定义提示词:可通过参数指定具体提示词。
- 画廊输出:生成 index.html 缩略图画廊,便于集中浏览。
- 提示词映射:输出 prompts.json,记录提示词与生成文件的对应关系。
- 参数控制:支持设置生成数量、模型、尺寸、质量和输出目录。
使用方式
环境准备
需要设置环境变量:OPENAI_API_KEY。
运行
可在任意目录运行(当存在 ~/Projects/tmp/... 时输出到该处,否则输出到 ./tmp/...):
python3 ~/Projects/agent-scripts/skills/openai-image-gen/scripts/gen.py
open ~/Projects/tmp/openai-image-gen-*/index.html
常用参数
python3 ~/Projects/agent-scripts/skills/openai-image-gen/scripts/gen.py --count 16 --model gpt-image-1.5
python3 ~/Projects/agent-scripts/skills/openai-image-gen/scripts/gen.py --prompt "ultra-detailed studio photo of a lobster astronaut" --count 4
python3 ~/Projects/agent-scripts/skills/openai-image-gen/scripts/gen.py --size 1536x1024 --quality high --out-dir ./out/images
输出内容
*.png图片文件prompts.json(提示词与文件的映射)index.html(缩略图画廊)
适用场景
- 需要一次性批量生成多张图片并集中查看。
- 希望通过随机提示词快速获得多样化的图像素材。
- 需要保留提示词与生成图片的对应关系以便追溯。
限制
- 依赖 OpenAI Images API,需要有效的
OPENAI_API_KEY。 - 运行环境需具备 Python 3。
- 具体可用模型、尺寸、质量取值以 OpenAI Images API 支持范围为准,资料中未提供完整清单。
- 关于费用、速率限制、并发能力等,资料暂未提供。