OpenAI Images API 图片背景参数怎么设置：三种模式选择

先按素材去向决定背景

background 可传入 transparent、opaque 或 auto，默认值为 auto。先写清素材交付方式，而不是只在提示词里要求背景颜色。

• 需要放进网页、海报或设计软件，并由后期自选底色时，选择 transparent。
• 成图将直接作为完整画面使用，且希望背景保持实体画面时，选择 opaque。
• 暂时没有确定背景策略，或正在做初步试图时，选择 auto，让模型自行决定。

透明背景适用于支持该能力的 GPT Image 模型。设置 transparent 时，输出格式应同时使用 png 或 webp。接口选择还不确定时，可先阅读生成和编辑接口的选择方法。

调用前准备一张需求卡

每次出图前记录用途、主体、背景策略和输出格式。这样批量任务出现白底时，能快速定位是参数还是后续保存环节的问题。

1. 确定用途，例如“电商主图”“网页悬浮图标”或“文章插画”。
2. 判断素材是否会覆盖在其他颜色或图片上。
3. 为透明素材指定 png 或 webp。
4. 记录本次的模型、background、output_format 和提示词。

在生成请求中设置 background

下面示例生成一个可叠放的商品元素。示例使用 Python SDK 的生成方法；将提示词替换成自己的主体描述即可。

from openai import OpenAI

client = OpenAI()

result = client.images.generate(
    model="gpt-image-1",
    prompt="A ceramic coffee mug, front view, isolated object",
    background="transparent",
    output_format="png",
    size="1024x1024"
)

image_base64 = result.data[0].b64_json

要生成完整的白色或其他实体背景画面，可将 background 改为 opaque。只做探索时改为 auto，不要把自动模式的结果当成透明背景承诺。

商品元素、网页素材和插画怎么选

以“咖啡杯素材”为例，同一句主体描述可按交付目标改变背景参数。

• 网页商品卡片要适配深浅两套主题：使用 transparent 与 png，后续由网页背景承接画面。
• 电商详情页需要一张完整的棚拍图：使用 opaque，并在提示词中描述希望出现的台面、光线或背景色。
• 还在比较杯子风格和构图：使用 auto 先出测试图，确定视觉方向后再固定背景模式重做交付版。

常见故障与修正动作

故障：设置透明后却得到不适合叠放的文件。原因可能是输出格式没有使用 PNG 或 WebP，或所选模型不支持透明背景。修正动作是确认模型能力，并将 background 设为 transparent、output_format 设为 png 或 webp 后重新请求。

故障：画面有白底，和透明通道混淆。原因是 opaque 或 auto 的结果本来就可能带实体背景。修正动作是不要仅凭预览底色判断，改用深色与浅色画布分别放置文件检查；需要可叠放素材时重新使用透明模式生成。

故障：透明素材边缘在深色页面上显得不自然。原因可能是主体边缘的视觉效果不适合当前底色，而不是背景参数失效。修正动作是在目标深浅底色上预览，必要时调整提示词中的主体轮廓、光线和边缘要求，再重新生成候选图。

发布前检查清单

• 确认背景模式与素材最终用途一致。
• 透明素材已使用 PNG 或 WebP 输出。
• 在浅色和深色底图上分别检查透明素材。
• 不透明素材的背景、主体和构图符合页面排版需求。
• 任务记录中已保存模型、背景参数、输出格式和提示词。
• 已保存最终文件，不依赖临时响应地址作为长期素材。