OpenAI Images API 透明 PNG 图标

准备

开始前准备好 OpenAI Python SDK、可用的 API 密钥，以及一个用于保存图片的本地目录。本文以生成单个图标为例，重点关注透明背景和 PNG 输出。

• 确定图标主体，例如“简洁的蓝色云朵图标”。
• 选择支持透明背景的 GPT Image 模型。
• 准备好保存 Base64 图片数据的代码环境。
• 准备浅色和深色两种底色，用于检查透明效果。

资料中的 Images API 支持通过 background 设置 transparent、opaque 或 auto。当使用透明背景时，output_format 应设置为 png 或 webp。本例选择 PNG，便于后续检查透明通道。

分步操作

1. 写清图标需求。提示词应包含主体、风格、构图和限制条件，例如要求主体居中、边缘清晰、不要阴影背景。不要只写“生成一个透明图标”，否则主体细节可能不稳定。
2. 设置透明背景和 PNG 格式。调用生成接口时，将 background 设为 transparent，将 output_format 设为 png。同时指定一个支持这些参数的 GPT Image 模型。
3. 读取返回结果。GPT Image 模型返回 Base64 编码的图片数据。取出响应中的图片数据后进行 Base64 解码，再以二进制方式写入本地 PNG 文件。
4. 检查文件格式。不要因为文件扩展名是 .png 就直接认定它透明。用图片编辑器、浏览器或图像处理工具查看是否存在透明通道，并将图片放到不同底色上观察边缘。
5. 保存版本信息。为文件记录模型、提示词、尺寸和生成时间，便于后续比较不同候选图。需要一次生成多张候选图时，可以参考OpenAI Images API 批量筛选图片的方法。

可复制模板或示例

下面是 Python SDK 的基础调用示例。响应字段的具体读取方式应以当前 SDK 返回对象为准，示例重点展示透明背景和 PNG 参数。

from openai import OpenAI
import base64

client = OpenAI()
result = client.images.generate(
    model="gpt-image-1",
    prompt="一个简洁的蓝色云朵图标，主体居中，轮廓清晰，扁平矢量风格，无背景，无文字，无额外装饰。",
    background="transparent",
    output_format="png",
    size="1024x1024",
    n=1,
)

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

如果你的 SDK 返回结构与示例不同，先打印响应对象确认图片数据所在字段，再调整读取代码。不要把 Base64 字符串直接写入 PNG 文件，否则得到的文件通常无法正常打开。

可复制的提示词结构如下：

主体：一个[对象]图标
风格：[扁平、线性或简洁立体]
构图：主体居中，四周保留适当透明空间
边缘：轮廓清晰，无白边、灰边和毛刺
背景：完全透明
限制：不添加文字、边框、棋盘格或场景背景

翻车怎么改

常见故障：图片看起来像透明，但放到网页上仍有白色方块。原因可能是只在提示词中描述了透明背景，没有设置 background；也可能是保存时没有正确解码 Base64 数据，或图片本身没有透明通道。修正时先确认模型支持透明背景，再同时设置 background="transparent" 和 output_format="png"，随后重新解码并用浅色、深色底色各检查一次。

常见故障：图标边缘出现白边或灰边。原因通常是提示词没有约束边缘，或者主体带有不适合透明背景的光晕。修正动作是加入“边缘清晰、无白边、无灰边、无外部阴影”的限制，并减少复杂发光效果；生成后再查看缩小尺寸时是否仍有明显毛边。

常见故障：接口报参数不支持。原因可能是所选模型不支持透明背景或当前参数组合。修正时对照当前 SDK 的参数定义，确认 background 和 output_format 的取值，再使用资料中列出的 GPT Image 模型重试。

完成前检查

• 发布前确认文件确实是 PNG，并且图片包含透明通道。
• 将图标放在至少两种不同底色上，检查是否出现白底、棋盘格或异常边缘。
• 确认主体没有多余文字、背景物或不需要的装饰。
• 确认图片尺寸符合网页、教程或海报的实际使用场景。
• 保存模型、参数和提示词，确保后续能够复现或筛选。