GPT Atelier 是一个围绕 OpenAI GPT Image 系列模型构建的图像生成与编辑工具集，封装了 Image API（单次调用）与 Responses API（多轮对话）两套接口，提供 6 个脚本，覆盖生成、编辑、合成、对话、流式输出和测试工作流。使用前提是配置 OPENAI_API_KEY 环境变量。
支持的模型
- 默认：gpt-image-2，基于推理，文本渲染准确率约 99%，单次最多生成 8 张一致图像，支持 4K 和流式输出。
- --fast：gpt-image-1.5，支持区域感知编辑，速度约为 4 倍，成本更低。
- --mini：gpt-image-1-mini，成本最低（低质量约 $0.006/张）。
主要能力与使用方式
1. 文生图
python3 scripts/generate_image.py "prompt" [options]
可指定 --size（WxH 或预设：square、landscape、portrait、wide、2k、4k、4k-portrait）、--quality（low/medium/high/auto，默认 high）、--n（1-8 张）、--format（png/jpeg/webp）、--compression、--background（opaque/transparent/auto）、--moderation（auto/low）。
2. 图像编辑
python3 scripts/edit_image.py "instruction" input.png [options]
额外支持 --mask（蒙版）和 --images（额外参考图）。黑白蒙版会自动转换为 RGBA（需 Pillow：pip install Pillow）。可用于区域感知编辑、整图风格转换、带参考图的编辑。
3. 多参考图合成
python3 scripts/compose_images.py "instruction" img1.png img2.png [img3.png ...] [options]
需要 2 张以上参考图，模型会生成一张融合所有参考的新图像。
4. 多轮对话式编辑（Responses API）
python3 scripts/converse_image.py [prompt] [options]
不带 prompt 时进入交互式 REPL，通过 previous_response_id 保持会话状态。交互命令包括 /save、/action、/model、/clear、/history、/help、/quit，可用 @path 附加图片。编排模型可选 gpt-5.4（默认）、--thinking（gpt-5.4-thinking，复杂场景构图更好但更慢）、--pro（gpt-5.4-pro，质量最高、最贵），也可用 --orchestrator 手动指定。
5. 模型对比
python3 scripts/compare_models.py "prompt" --open
对同一提示词在多个模型上生成结果，输出深色主题的 HTML 对比页面。
6. 流式生成
python3 scripts/stream_image.py "prompt" --partials N [options]
在生成过程中输出部分图像，最后输出完整图像，--save-partials 可保存中间图像。
7. 连接测试
python3 scripts/test_connection.py --check-models
提示词要点
以场景/风格开头而非主体，开头词语视觉权重最高；说明用途（广告、UI 原型、编辑）以便模型选择合适精细度；字面文本始终用双引号包裹以启用高精度文本渲染；在提示词中写明像素尺寸，自定义宽高比时追加“Output in exactly WxH (R:R ratio) resolution”，gpt-image-2 会自动通过 inject_size_hint() 处理；复杂场景使用 --thinking；设计成品建议从零生成而非编辑，因为 gpt-image-2 的参考图编辑可能产生黄色偏色和提示词遵循度下降。
成本控制
构思阶段用 --quality low（约 $0.006/张），评审阶段用 medium（约 $0.05），最终成品用 high（约 $0.21）。--fast 更便宜，--mini 最省，--format jpeg 响应更快。
脚本一览
generate_image.py（文生图，Image API）、edit_image.py（蒙版/参考图编辑，Image API）、compose_images.py（多参考合成，Image API）、converse_image.py（多轮编辑，Responses API）、compare_models.py（模型对比 HTML，Image API）、stream_image.py（流式部分图像，Image API）、test_connection.py（连接检查，Models API）。
参考文档
references/api-reference.md（完整参数、定价、尺寸限制）、references/compare-models-reference.md（对比脚本选项与 HTML 输出）、references/prompting-guide.md（提示词工程、文本渲染、风格关键词）、references/troubleshooting.md（错误码、内容政策、速率限制）。
适用场景与限制
适用于产品摄影、缩略图、Logo 设计、UI 原型、多元素复杂场景等图像创作。限制方面：参考图编辑在 gpt-image-2 上可能出现黄色偏色，建议改用 --fast；蒙版重绘为原生支持、漂移较低；多图一致性单次最多 8 张；流式部分图像为原生支持；深色/艺术主题政策较严格；任意宽高比需为 16 像素倍数。