OpenAI Images API 图片输出格式和压缩参数怎么选

准备

先为每类图片写一条交付规则：图标和抠图素材是否必须透明、网页展示是否优先减小文件、后台是否要保存原始结果。GPT Image 模型可用的输出格式为 png、jpeg、webp，默认是 PNG。output_compression 取值为 0 到 100，只适用于 GPT Image 模型的 JPEG 和 WebP 输出，默认值为 100。

• 透明图标、透明贴纸：选 PNG 或 WebP，并设置 background="transparent"。
• 不需要透明背景的网页配图：优先测试 WebP 或 JPEG。
• 需要保留透明通道或作为后续编辑素材：选 PNG，不设置压缩参数。

透明图标的参数与验收细节可参考透明 PNG 图标设置方法。

分步操作

1. 确定用途。需要叠在不同底色上的图片，归入透明素材；文章头图、卡片配图等不要求透明的图片，归入网页展示素材。
2. 选择格式。透明素材使用 PNG 或 WebP；不透明照片感配图可使用 JPEG 或 WebP；不确定时先输出 PNG 做视觉基准。
3. 仅在 JPEG 或 WebP 时设置 output_compression。先以 80 作为测试值，保存文件大小和肉眼效果；若细节可接受再下调，若出现块状失真或边缘脏污则调高。
4. 将输出的 Base64 数据解码后保存，并用实际页面背景查看效果。GPT Image 模型的结果以 Base64 编码返回，不能把响应内容直接当作普通图片链接长期使用。
5. 把 model、size、output_format、output_compression、background 和最终文件大小一并写入记录，批量生产时固定同一用途的规格。

可复制模板或示例

下面示例用于生成不透明网页配图，使用 WebP 并将压缩值设为 80。该值是便于开始对比的工作起点，不是所有图片的固定最优值。

from openai import OpenAI
import base64

client = OpenAI()

result = client.images.generate(
    model="gpt-image-1",
    prompt="一张用于文章头图的简洁工作台场景，无文字",
    size="1536x1024",
    output_format="webp",
    output_compression=80,
    background="opaque"
)

image_bytes = base64.b64decode(result.data[0].b64_json)
with open("article-cover.webp", "wb") as file:
    file.write(image_bytes)

透明素材可改为以下参数，不要使用 JPEG：

output_format="png"
background="transparent"

团队可直接采用这份规则：透明资产=PNG 或 WebP，不设压缩；网页展示=WebP，先测 80；仅需不透明交付=JPEG 或 WebP，按样张调整压缩值；每次保存实际文件大小。

翻车怎么改

常见故障：生成的透明图在网页上变成白底。原因通常是选择了 JPEG，或设置透明背景时未使用 PNG 或 WebP。修正动作是将 output_format 改为 png 或 webp，保留 background="transparent"，重新生成后分别放到深色和浅色底图上检查。

常见故障：图片体积仍然过大。原因可能是输出了 PNG，或 WebP、JPEG 仍使用默认压缩值 100。修正动作是确认图片不需要透明后切换为 WebP 或 JPEG，再从 80 开始测试 output_compression，每次只改一个数值并对比文件大小与关键细节。

完成前检查

• 发布前验收项：实际文件扩展名与 output_format 一致，且图片能在目标页面正常加载。
• 透明素材已在深色和浅色背景上检查，没有白底、灰边或意外底色。
• JPEG 或 WebP 已记录 output_compression 和文件大小，PNG 没有误填该压缩参数。
• 同一栏目或素材类型使用了统一的格式、尺寸和命名规则。