核心用法
openai-image-gen 是一个命令行图像生成工具，通过调用 OpenAI Images API 批量创建 AI 图像。其工作流程包含三步：
1. 提示词生成：内置随机采样器自动生成结构化提示词，或接受用户自定义 --prompt
2. API 调用：支持 gpt-image-1.5 等模型，可配置 --count、--size、--quality 等参数
3. 本地渲染：输出 PNG 图像、prompts.json 元数据文件，以及可直接浏览器打开的 index.html 缩略图画廊
典型命令示例
# 默认生成（8张，自动提示词） python3 .../gen.py # 自定义数量与模型 --count 16 --model gpt-image-1.5 # 指定提示词与输出目录 --prompt "ultra-detailed studio photo..." --out-dir ./out/images
显著优点
- 开箱即用：仅需
OPENAI_API_KEY，无需额外依赖配置 - 批量高效：单次可生成多张图像，适合素材储备场景
- 智能提示词：随机采样器降低创意门槛，避免"空白提示焦虑"
- 可视化输出：自动生成 HTML 画廊，便于即时预览与筛选
- 路径自适应：优先输出到
~/Projects/tmp/，兼容开发工作流
潜在局限
- 成本敏感：OpenAI 图像 API 按分辨率计费，批量生成易产生费用
- 风格不可控：随机提示词结果质量波动，需人工筛选
- 无本地模型：完全依赖云端 API，断网/限流时不可用
- 输出路径硬编码：虽支持
--out-dir，但默认行为依赖特定目录结构
适合人群
- 设计师/创作者：快速生成灵感素材、概念图
- 开发者：需要批量图像数据进行测试或原型验证
- 内容运营：社交媒体配图、文章插图的高效生产
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | 需妥善保管 `OPENAI_API_KEY`，避免硬编码提交至版本控制 |
| 内容合规 | 生成内容需符合 OpenAI 使用政策，避免版权争议内容 |
| 费用超支 | 建议设置 API 用量告警，特别是高分辨率+大批量组合 |
| 输出覆盖 | 默认以时间戳命名目录，但自定义 `--out-dir` 时需注意文件覆盖 |
> 注意：安全认证报告为占位符，未执行实际安全扫描，生产环境使用前建议补充依赖审计与代码审查。