展开本页目录
开始前准备什么
- 保存未修改原图，写清只改哪里和哪些内容必须保留。
- 先统一最终提交画布；本页本地生成器限定真实 PNG，应用上限 20 MiB、1600 万像素。
- 确认型号和当前通道支持 mask 的提交方式，不能从普通图片编辑成功推断蒙版透传。
- 准备一次候选预算，检查输出目录可写，不自动重复提交。
- 固定原图画布
- 建立透明 mask
- 本地检查
- 提交一次
- 对照与合成
仅读取自己的 PNG，按 x、y、宽、高生成同画布透明区域 mask；需 Pillow，不联网、不修改原图、不提交 API。
把原图、mask、编辑目标和保留项与结果绑定，未核实的费用留空。
包括真实请求规格、输出规格、usage、单次账单与验收结果；费用仅代表本次测试通道。
黑白看起来对，还要检查真实 alpha
白色预览并不自动等于不透明，黑色也不自动等于透明。保留原图与 mask 同格式、同画布宽高；官方允许值和文件限制以所选接口为准，本页采用更小的应用上限方便本地准备。
| 文件区域 | 提交给编辑接口的含义 | 怎么核对 |
|---|---|---|
| alpha = 0 的透明区域 | 本页 mask 约定的待编辑区域 | 棋盘格预览与 alpha 数值对应 |
| alpha = 255 的不透明区域 | 希望保留的区域 | 不是靠 RGB 白色才决定保留 |
| 只有黑白 RGB，无 alpha | 不满足本页 PNG 蒙版准备规则 | 转换并重新检查透明通道 |
| 尺寸或裁切错位 | 选区落在错误物体上 | 原图与 mask 同画布叠加预览 |
- 文件区域
- alpha = 0 的透明区域
- 提交给编辑接口的含义
- 本页 mask 约定的待编辑区域
- 怎么核对
- 棋盘格预览与 alpha 数值对应
- 文件区域
- alpha = 255 的不透明区域
- 提交给编辑接口的含义
- 希望保留的区域
- 怎么核对
- 不是靠 RGB 白色才决定保留
- 文件区域
- 只有黑白 RGB，无 alpha
- 提交给编辑接口的含义
- 不满足本页 PNG 蒙版准备规则
- 怎么核对
- 转换并重新检查透明通道
- 文件区域
- 尺寸或裁切错位
- 提交给编辑接口的含义
- 选区落在错误物体上
- 怎么核对
- 原图与 mask 同画布叠加预览
先离线生成一个可核对的矩形区域
生成器把矩形内设为完全透明、外部设为不透明，输出与真实原图相同尺寸；输入必须是可完整解码的 PNG，矩形不能越界，已有输出不会被覆盖。先在本地工具查看原图和 mask，人工确认选区。圆形、发丝和复杂轮廓应在图片编辑器制作，再做同样的 alpha 与对齐检查。
示例矩形：左上角 (420, 300)，宽 200、高 180；须按自己的图调整
python3 -m pip install Pillow
python3 make-edit-mask.py --input ./source.png --output ./mask.png --rect 420 300 200 180图片、mask 和提示词，各自负责一件事
在当前通道支持的 /v1/images/edits 请求中分别放原图与 mask，字段形态按接入文档核对。多张输入时，OpenAI 指南将 mask 应用于第一张图；不要把风格参考排在目标原图前。蒙版准备正确只说明输入具备条件，仍需一次实际响应证明当前通道生效。
局部编辑提示词：用自己的对象和选区替换
基于上传原图，修改蒙版透明区域中的[对象/内容]：
目标：[准确颜色、材质或替换物]。
尽量保留透明区域外的构图、主体数量、Logo、文字和边缘。
不要扩展画布，不移动主体，不增加其他物体。
输出将与原图逐项对照；蒙版边界与未选区域不假定绝对不变。选区内部和外部，分别验收
需要像素级保留时，以原图为底，把通过验收的局部输出按自己的选区合成回来；这是一道本地后处理，不是模型保证。选区触及阴影或透视边界时，可能需要适当扩大过渡区域再人工修边。
| 区域 | 要检查 | 失败处理 |
|---|---|---|
| 透明区域内部 | 对象变化是否符合目标、纹理和光线是否自然 | 改提示词或选区后新建修订任务 |
| 选区边缘 | 接缝、光晕、重复纹理和遮挡关系 | 放大修边或重新合成 |
| 不透明区域 | Logo、文字、脸部和主体形状是否变化 | 需要精确保留时取原图像素 |
| 整个文件 | 实际画布、格式与最终用途 | 本地确定性裁切或导出，不盲目重生成 |
- 区域
- 透明区域内部
- 要检查
- 对象变化是否符合目标、纹理和光线是否自然
- 失败处理
- 改提示词或选区后新建修订任务
- 区域
- 选区边缘
- 要检查
- 接缝、光晕、重复纹理和遮挡关系
- 失败处理
- 放大修边或重新合成
- 区域
- 不透明区域
- 要检查
- Logo、文字、脸部和主体形状是否变化
- 失败处理
- 需要精确保留时取原图像素
- 区域
- 整个文件
- 要检查
- 实际画布、格式与最终用途
- 失败处理
- 本地确定性裁切或导出，不盲目重生成
实际输入：只希望修改鲸鱼喷水区域
2026-10-08，通过 gpt-image-2 的 /v1/images/edits 提交一次原图与 mask。请求 size=1024x1024、quality=low，没有自动重试；提示词要求保护鲸鱼、腹部、五官、白底和其他部位。
实际请求的原图，1254×1254 PNG；原图来自已有 apizt 图片案例。本次目标只将喷水改为金黄色。
实际蒙版：同画布、有透明选区
保留该次请求的实际 mask，透明区用于引导喷水编辑；蒙版输入正确不保证模型保持未选区域。
返回了图片，但局部保持验收未通过
这是一次具体输入与通道的结果，不能推断所有蒙版任务都会失败，也不能宣传该通道能精确锁定区域。需要保留腹部原色时，应将通过检查的喷水区域合成回原图，再单独进行尺寸处理和内容验收。
| 检查 | 实际结果 | 判断 |
|---|---|---|
| 请求 | HTTP 200，耗时 57.806 秒，已收到 PNG | 只代表接口返回成功 |
| 目标选区 | 喷水由蓝色变为黄色 | 目标变化可见 |
| 保留区域 | 鲸鱼腹部由浅蓝变为黄色 | 未选区漂移，保留项未通过 |
| 输出规格 | 请求 1024×1024，实际 1254×1254 | 尺寸未通过 |
| usage | input 811、output 765、total 1576 tokens | 已与本人调用日志匹配 |
| 单次实际扣费 | USD 0.001724，日志完成时间 2026-10-08 02:40:57 | 仅代表本次测试通道，不是通用报价 |
- 检查
- 请求
- 实际结果
- HTTP 200，耗时 57.806 秒，已收到 PNG
- 判断
- 只代表接口返回成功
- 检查
- 目标选区
- 实际结果
- 喷水由蓝色变为黄色
- 判断
- 目标变化可见
- 检查
- 保留区域
- 实际结果
- 鲸鱼腹部由浅蓝变为黄色
- 判断
- 未选区漂移，保留项未通过
- 检查
- 输出规格
- 实际结果
- 请求 1024×1024，实际 1254×1254
- 判断
- 尺寸未通过
- 检查
- usage
- 实际结果
- input 811、output 765、total 1576 tokens
- 判断
- 已与本人调用日志匹配
- 检查
- 单次实际扣费
- 实际结果
- USD 0.001724，日志完成时间 2026-10-08 02:40:57
- 判断
- 仅代表本次测试通道，不是通用报价
保留 2026-10-08 单次 API 实测的 WebP 展示副本；HTTP 成功并未通过局部保持和尺寸验收，不能据此推断所有蒙版任务。
把输入校验、接口返回和内容通过分别记录
本地蒙版生成器只帮助准备输入。上述实测证明该次请求收到了图片，但未证明 mask 精确透传或未选区保持；实际费用应与自己的调用账单核对。
参数拒绝先看字段、编码和画布；HTTP 成功但改错位置时，先检查 alpha、目标图顺序和选区对齐，再看模型能力。不要在还没定位问题时重提整批任务。
怎样确认已经完成
- 原图未覆盖，mask 与最终提交原图同格式、同宽高。
- 待编辑区域确实透明，保留区域不透明，选区没有错位。
- 输出已检查选区内部、边缘与未选区的变化。
- 严格保留项已从原图合成并再次验收。
- 当前通道支持与实际费用只引用自己的证据。
常见问题
mask 能保证只改选中的部分吗？
不能。GPT Image 的 mask 是引导，边界与外部可能变化。必须对照原图；需要严格保留时再做原图像素合成。
黑白 JPG 蒙版可以直接提交吗？
本教程要求有真实 alpha 的 PNG，并与 PNG 原图同画布。JPG 不保存透明度；将黑白图转成带 alpha 的 mask 后重新检查。