截至 2026 年 9 月，gpt-image-2 已能通过 OpenAI API 请求透明背景，但这项能力仍处于 preview。最短的正确路径是：请求体设置 background: "transparent"，输出选择 PNG 或 WebP，解码返回的 base64 数据后，再检查文件是否真的包含非完全不透明的 Alpha 像素。
只在提示词里写“透明背景”并不等价于启用透明输出；把文件命名为 .png 也不代表它含有透明通道。更容易误判的是，图片里可能真的画了一层灰白棋盘格，看起来像设计软件的透明预览，实际每个像素仍然是不透明的。
请求里需要同时成立的三个条件
OpenAI 的当前图片生成指南把直接生成和编辑归在 Image API 中；透明背景的具体规则则写在官方 GPT Image 提示指南里。对 gpt-image-2，以下条件缺一不可：
background明确设为transparent，不要依赖auto自行判断；output_format使用png或webp，不要使用jpeg；- 提示词描述一个独立主体，并排除场景、纯色底、棋盘格和不需要的投影。
PNG 默认适合保留无损边缘，不需要传 output_compression。如果资产数量多、页面体积敏感，可以选择 WebP 并按需要设置压缩；但从 API 收到文件以后，后续转换、上传和 CDN 优化都必须继续保留 Alpha 通道。
下面的 Python 请求会生成一个可以放到不同颜色卡片上的独立图标，并把返回内容直接保存为 PNG：
pythonimport base64 from openai import OpenAI client = OpenAI() result = client.images.generate( model="gpt-image-2", prompt=( "Create one centered glass compass icon as an isolated asset. " "Fully transparent background, crisp silhouette, clean edges. " "No scene, solid backdrop, checkerboard, border, or cast shadow." ), background="transparent", output_format="png", size="1024x1024", quality="medium", ) image_bytes = base64.b64decode(result.data[0].b64_json) with open("compass.png", "wb") as image_file: image_file.write(image_bytes)
环境变量中的 API 密钥、组织验证和模型访问权限仍按你的 OpenAI 项目管理。一次返回 200 只说明接口接受并完成了请求，不代替对最终文件内容的验收。
编辑已有商品图时，透明不是“顺便去底”
已有商品照、Logo 或角色素材更适合调用 Image API 的编辑接口。此时提示词要把“哪些不能变化”说清楚：主体几何、标签文字、颜色和比例需要保留，而背景、地面接触阴影或拍摄环境才是要移除的部分。
官方的商品素材示例同样使用 gpt-image-2、background="transparent" 和 PNG 输出。一个实用的编辑说明可以这样写：
textIsolate the product on a fully transparent background. Preserve its geometry, colors, label text, and proportions. Keep a crisp silhouette with no halos or fringing. Do not add scenery, a solid backdrop, a checkerboard, or a shadow.
如果之后继续修改颜色、文字或局部细节，每一轮都要再次要求保留透明背景。多轮编辑会重新生成输出；前一轮有 Alpha 并不能保证下一轮自动维持同样的背景状态。
纤细毛发、半透明玻璃、烟雾、柔光和毛绒边缘不能简单按“前景完全不透明、背景完全透明”处理。它们需要过渡 Alpha，边缘验收也应放在浅色和深色两种底图上进行，否则白边或黑边很容易被漏掉。
用像素检查，而不是凭预览猜测
最可靠的快速检查不是看文件扩展名，而是打开解码后的图片，读取 Alpha 通道的取值范围。下面的 Pillow 脚本会确认图片是否有透明通道，并报告完全透明、半透明和完全不透明像素的数量：
pythonfrom PIL import Image image = Image.open("compass.png").convert("RGBA") alpha = image.getchannel("A") histogram = alpha.histogram() transparent = histogram[0] opaque = histogram[255] translucent = sum(histogram[1:255]) total = image.width * image.height print({ "size": image.size, "transparent_pixels": transparent, "translucent_pixels": translucent, "opaque_pixels": opaque, "transparent_ratio": round(transparent / total, 4), }) if transparent == 0 and translucent == 0: raise ValueError("文件没有可用的透明或半透明像素")
这个检查回答的是“文件里有没有透明度”，不是“抠图质量是否合格”。对于居中小物体，通常应有明显的完全透明区域；对于铺满画布的烟雾或玻璃纹理，半透明像素可能更多。验收阈值要跟素材用途绑定，不能把某个透明比例写成所有图片的统一标准。
还可以把图片分别铺在纯黑、纯白和品牌主色背景上观察。若边缘出现固定白圈，通常说明上一步把颜色与透明度混合进了边缘像素；若格子在三个底色上都不变，说明格子已经被画进 RGB 内容，并不是查看器的透明指示。
常见失败应从文件和请求两端排查
| 表现 | 更可能的原因 | 下一步 |
|---|---|---|
| 返回 JPEG 或保存后变成 JPEG | 输出格式或后处理链路改写了文件 | 显式请求 PNG/WebP，并检查实际 MIME 与文件头 |
| PNG 打开仍是纯白底 | 没传 background: "transparent"，或中间服务没有转发参数 | 记录最终请求体；直连官方接口做最小请求对照 |
| 图片里出现灰白格子 | 提示词让模型把“透明”画成视觉效果 | 排除 checkerboard，并用 Alpha 脚本确认通道 |
| 第一轮透明，编辑后恢复背景 | 后续编辑未要求维持透明 | 每轮编辑都重申 fully transparent background |
| 深色背景上有白边 | 原背景颜色污染了半透明边缘 | 同时在明暗底色上验收，必要时做边缘修复 |
| 本地正常，上线后不透明 | 转码、缩略图或 CDN 清除了 Alpha | 对最终交付文件重新运行像素检查 |
如果你使用的是兼容 OpenAI 的第三方网关，不能仅凭它接受同名字段就认定行为与官方一致。至少记录实际模型、最终请求体、返回 MIME、图片字节和 Alpha 统计。某个服务把未知参数静默忽略时，请求可能仍返回成功，但得到的是普通不透明图。
什么时候应保留后处理方案
原生透明输出减少了先做纯色背景再抠图的步骤，尤其适合形状明确的商品、贴纸、图标和界面装饰。不过 preview 不是质量保证。复杂发丝、透明材质、柔和光晕、精确品牌标签和大批量一致性仍应在你的真实素材上抽样，并为不合格结果保留背景移除或蒙版修正方案。
如果你的下一步是先把基本图片调用方式、Images API 与 Responses 工具的差别理清，可以继续看 GPT Image 2 API 与 Codex 的路线说明。如果当前任务只要求一个可复用透明资产，则保持 Image API 请求简单、保存原始输出，并把 Alpha 检查放在每一次转换之后，通常比不断追加提示词更可靠。
