OpenAI Images API 透明 PNG 图标：参数设置与透明背景检查

开始前准备

需要把图标放进网页、教程或海报时，最常见的问题是生成结果带白底、灰底，或者预览看起来透明，导出后却出现一块矩形背景。原因通常不只是提示词，而是模型能力、背景参数、输出格式和保存方式没有对齐。生成前先把图标用途和验收标准写清楚。

• 确定主体，例如下载箭头、蓝色云朵、锁、购物袋或音符。一次只生成一个核心图标，避免多个对象互相干扰。
• 确定风格，例如扁平几何、统一色块、轻微圆角或简洁线性风格。不要把写实、玻璃、金属和手绘等冲突方向同时放进一轮。
• 确定构图，写清正面视角、居中、完整显示和四周安全留白，避免主体贴近画布边缘。
• 确定输出目标。需要透明通道时，输出格式应使用 PNG 或其他明确支持透明的格式；本篇以 PNG 为主。
• 准备保存目录，并记录模型、提示词、尺寸、质量、背景模式和生成版本，后面修正时不要覆盖原文件。

接口资料确认，图像生成方法需要提供 prompt，并可传入 model、background、output_format、size、quality 和 n 等参数。透明背景不是所有模型都支持，资料明确说明 gpt-image-2 与 gpt-image-2-2026-04-21 不支持透明背景，因此不能只看到模型名称就默认可以输出透明图。

如果你还需要整理图标主体、构图和限制词，可以顺带参考透明 PNG 图标提示词写法，但本文重点仍然是 Images API 的透明参数、返回数据保存和结果验收。

参数设置

透明 PNG 图标的核心组合是 background="transparent" 与 output_format="png"。前者指定背景模式，后者指定生成文件格式。资料说明，当背景设为透明时，输出格式需要支持透明通道，因此应选择 PNG 或 WebP。JPEG 不适合承担透明输出。

不要给 GPT image 模型额外设置旧式的 response_format 来强行要求 Base64 或临时地址。资料明确说明，GPT image 模型始终返回 Base64 编码的图片数据，response_format 只适用于 DALL-E 2 和 DALL-E 3 的 URL 或 Base64 返回方式。透明背景又要求使用支持该能力的 GPT image 模型，因此两套返回逻辑不要混用。

分步操作

从一张简单的方形图标开始，先验证透明输出链路，再增加风格细节。每一步都保留请求记录和结果文件。

1. 确定图标主体：写出一个清楚的对象，例如“蓝色下载箭头，搭配简洁圆角托盘”。说明颜色、形状和用途，但不要加入品牌名或需要准确绘制的文字。
2. 固定构图：加入“单一主体、正面视角、居中构图、完整显示、四周保留安全留白”。图标需要缩小使用时，优先保证轮廓清楚，不要堆叠过细装饰。
3. 写透明限制：在提示词中说明真正透明背景、不要白色背景、不要彩色背景、不要绘制棋盘格纹理。棋盘格是某些软件的预览方式，不应变成图像像素。
4. 设置 API 参数：使用支持透明背景的 GPT image 模型，设置 background="transparent"、output_format="png"、合适的 size、quality 和 n=1。
5. 读取返回数据：GPT image 模型返回 Base64 编码图片数据。程序需要取出返回结果中的图片数据，使用 Base64 解码后写入以 .png 结尾的文件。
6. 保存版本：用主体、尺寸和版本号命名，例如 download-icon-1024-v01.png，同时保存对应的提示词文本和参数记录。
7. 检查透明背景：把 PNG 放到纯白、浅灰和深色背景上查看。如果四周始终没有矩形底色，再打开支持 Alpha 通道查看的图像工具，确认背景区域确实为透明。
8. 检查边缘：放大图标外轮廓，查看是否有白边、灰边、彩色溢出、毛刺、缺口或模糊光晕。透明通道正确，不代表边缘一定干净。

from openai import OpenAI
import base64

client = OpenAI()

prompt = """一枚蓝色下载箭头图标，箭头向下，搭配简洁的圆角托盘，
用于网页下载按钮，单一主体，正面视角，居中构图，完整显示，
四周保留安全留白，扁平几何风格，轮廓闭合，边缘清晰利落，
无锯齿，无白边，无灰边，无光晕，无背景残留，真正透明背景，
不要白色背景，不要彩色背景，不要棋盘格纹理，不要文字，
不要额外装饰，输出透明 PNG 图标。"""

result = client.images.generate(
    model="gpt-image-1.5",
    prompt=prompt,
    background="transparent",
    output_format="png",
    size="1024x1024",
    quality="auto",
    n=1,
)

image_base64 = result.data[0].b64_json
with open("download-icon-1024-v01.png", "wb") as file:
    file.write(base64.b64decode(image_base64))

这段示例展示的是调用结构和保存思路。实际运行前，应根据当前 SDK 和账号可用模型核对模型名称、字段结构及参数兼容性。如果请求报错，先检查模型是否支持透明、参数名称是否属于当前接口、输出格式是否与背景模式匹配，再修改提示词。

可复制模板

下面的模板适合网页按钮、教程配图和海报素材。方括号替换为自己的内容，没用到的部分可以删掉。提示词负责表达画面意图，真正的透明输出仍由 API 参数决定。

[主体名称]，用于[网页按钮/教程配图/海报素材]的可复用图标，单一主体，正面视角，居中构图，完整显示，四周保留安全留白，主体颜色为[颜色]，采用[扁平几何/简洁线性/统一色块]风格，轮廓闭合，边缘清晰利落，无锯齿，无白边，无灰边，无彩色溢出，无模糊光晕，无背景残留，真正透明背景，不要白色背景，不要彩色背景，不要棋盘格纹理，不要额外物品，不要文字，不要字母，不要数字，不要标识，不要 Logo，不要水印，输出透明 PNG 图标。

例如制作一个云朵图标：

一枚蓝色云朵图标，用于网页功能入口，单一主体，正面视角，居中构图，完整显示，四周保留安全留白，圆润简洁的扁平几何风格，颜色统一，轮廓闭合，边缘清晰利落，无锯齿，无白边，无灰边，无彩色溢出，无模糊光晕，无背景残留，真正透明背景，不要白色背景，不要彩色背景，不要棋盘格纹理，不要雨滴、太阳和其他额外物品，不要文字，不要字母，不要数字，不要标识，不要 Logo，不要水印，输出透明 PNG 图标。

如果要制作一组风格一致的图标，固定“风格、视角、构图、边缘要求和输出要求”，只替换主体名称与主体颜色。每次只生成一个主体，并给文件名加入主体名称。这样可以减少不同图标之间的画布、轮廓和细节差异。

翻车修正

背景整片变白或变灰：先检查模型是否支持透明背景，再确认 background 是否设置为 transparent，以及 output_format 是否为 PNG 或 WebP。如果当前模型不支持透明，重复增加“透明背景”不会替代接口能力，应更换为当前确认支持透明的模型。

棋盘格被画进图片：删除“透明棋盘、棋盘格背景、透明网格”等可能被模型理解为画面内容的表达，改成“真正透明背景，不要绘制背景纹理”。将文件放到纯黑和纯白背景上观察，确认棋盘格不是实际像素。

主体边缘出现白边：删掉发光、柔光、雾气和扩散阴影等容易越过轮廓的描述，补充“硬朗清晰的闭合轮廓、无白色光晕、无灰色描边、无背景溢出”。主体形状已经合格时，优先只处理边缘，不要同时更改颜色和风格。

边缘毛刺或缺口：减少过细装饰和复杂纹理，要求细节简化、轮廓连续、边缘平滑。检查主体是否贴近画布边缘，必要时重新生成留白更多的版本。

透明预览正常但导出有底色：不要只看文件扩展名或软件棋盘格预览。把文件放到不同颜色背景上，再用能查看 Alpha 通道的图像工具检查。若确认没有透明通道，重新核对 API 参数和 Base64 保存流程，尤其不要在保存过程中把图片转成 JPEG。

主体变形或出现额外物品：先简化提示词，只保留一个主体、颜色、视角、构图和边缘限制。不要一轮同时修改主体、风格、尺寸和背景要求。保存上一版结果，逐次比较变化来源。

请求提示参数不支持：检查所选模型对 background、output_format、quality 和 size 的支持范围。尤其注意透明背景不是所有 GPT image 模型都支持，DALL-E 的返回参数也不能直接套用到 GPT image 模型。

完成前检查

交付给网页、教程或海报前，按“参数、文件、透明、边缘、用途”的顺序检查。只要有一项无法确认，就不要直接把文件放进最终页面。

• 模型是否属于当前接口确认支持透明背景的 GPT image 模型。
• background 是否为 transparent，没有误用 opaque 或 auto。
• output_format 是否为 PNG 或其他支持透明的格式，没有保存成 JPEG。
• 是否按照 GPT image 模型的 Base64 返回方式读取和解码图片，没有套用临时 URL 逻辑。
• PNG 文件能否正常打开，文件名、尺寸和版本号是否便于追溯。
• 放在白色、浅色和深色背景上时，图标四周是否没有矩形底色。
• 背景区域是否确实拥有透明通道，而不是保存了一块白色或灰色像素。
• 主体是否完整，四周是否有足够安全留白，没有被画布边缘裁切。
• 轮廓是否闭合，是否存在白边、灰边、彩色溢出、毛刺、缺口或模糊光晕。
• 图标缩小到网页按钮或教程插图尺寸后，主体是否仍然容易识别。
• 画面中是否没有文字、字母、数字、标识、Logo、水印和棋盘格纹理。
• 是否保存了完整提示词、模型、背景模式、输出格式、尺寸、质量和数量参数。

这套流程的关键是把“想要透明”拆成四个可核对动作：提示词说明不要绘制背景，API 使用透明背景参数，输出格式保留透明通道，保存后用不同底色和 Alpha 检查结果。只有四项都通过，生成的 PNG 图标才适合继续放进网页、教程或海报排版。