> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2.6 官转：输出格式和背景参数有哪些互斥条件？

> 适用于 GPT Image 2.6 官转的 gpt-image-2.6-sunburst / gpt-image-2.6-flare：只有 transparent + jpeg 会 400，gif 支持 1-bit 透明，svg 用 opaque 才写白底。

> [!NOTE]
>
> 本文适用于 **GPT Image 2.6 官转** 的两款模型：`gpt-image-2.6-sunburst`（精细视觉）和 `gpt-image-2.6-flare`（快速迭代）。2.5 / 2 没有 gif / svg 输出，规则不要直接套用。

## 简短回答

只有一组硬互斥：`background: "transparent"` 不能配 `output_format: "jpeg"`，会直接返回 400。其余组合都能通过，但透明能力不同：

| `background` | `png` | `jpeg` | `webp` | `gif` | `svg` |
| - | - | - | - | - | - |
| `transparent` | ✅ 完整 alpha | ❌ 400 | ✅ 完整 alpha | ✅ 1-bit 透明 | ✅ 不写背景 |
| `opaque` | ✅ 实底 | ✅ 实底 | ✅ 实底 | ✅ 实底 | ✅ 白底矩形 |
| `auto` | ✅ | ✅ | ✅ | ✅ | ✅ |

以上为 2026-11-12 在 GPT Image 2.6 官转上实测（`quality: "low"`、`n: 1`；GIF 用 512×512 / 2 帧；SVG 用 `svg.model: "gpt-4.1-mini"`）。完整矩阵以 `gpt-image-2.6-sunburst` 为主；`jpeg + transparent`、`gif + transparent`、`svg + opaque` 三组在 `gpt-image-2.6-flare` 上复测结果一致。

## JPEG 是唯一的 400

JPEG 没有 alpha 通道，`background: "transparent"` 会直接报：

```text theme={null}
Transparent background is not supported for JPEG output format
```

文生图 `/v1/images/generations` 和图片编辑 `/v1/images/edits` 都一样。改成 `png` / `webp`（要动画就 `gif`）即可；`opaque` 和 `auto` 在 JPEG 下正常。

> [!WARNING]
>
> 编辑接口这条 400 实测要 62 秒才返回（文生图约 19 秒），不要因为等得久就重复提交。

## GIF 能透明，但只有 1-bit alpha

`output_format: "gif"` + `background: "transparent"` 在 2.6 上可用，文生图和编辑接口都通过。实测透明像素占比 46%–60%，`opaque` 对照组为 0%。

但 GIF 的透明是调色板透明，只有“全透明 / 不透明”两种状态，没有半透明羽化；边缘要求高时用 `png` / `webp`。这条只适用于支持 GIF 输出的 2.6，2.5 及以前没有 GIF 输出。

## SVG 没有 alpha，`opaque` 才写背景

SVG 是矢量格式，本身没有 alpha 通道，透明是默认状态：

* `transparent`：不写背景矩形。
* `opaque`：写入一张全画布白色矩形，例如 `<rect width="1024" height="1024" fill="#fff" />`。
* `auto`：实测两次都没写背景，不能当 `opaque` 用；要白底请显式传 `opaque`。

> [!NOTE]
>
> `output_format: "svg"` 只支持文生图接口，`n` 必须为 1，并且必须带 `svg.model`；背景矩形的最终写法由编写模型落笔，换 `svg.model` 后需以实际文件为准。

## `auto` 不是固定 `opaque`

`background` 不传时默认 `auto`。`auto` 会跟着提示词语义走，而不是固定输出实底：

* 提示词写“纯白背景”时，`png` / `jpeg` / `gif` 回显 `opaque`，实际无 alpha。
* 提示词写“主体、无背景”时，`png` / `webp` / `gif` / `svg` 回显 `transparent`，前三种实际带透明像素。
* `jpeg` 下 `auto` 会被强制成 `opaque`，不报错。

所以生产环境想要确定性，显式传 `transparent` 或 `opaque`；不要用 `auto` 去赌结果。

## 顺带两个格式约束

* `output_compression` 只对 `jpeg` / `webp` 生效。
* `frame_count` / `frame_duration_ms` 只用于 `gif`，不要传给 PNG、JPEG、WebP 或 SVG。

## 相关文档

> [card] [GPT Image 2.6 新能力](https://docs.apiyi.com/api-capabilities/gpt-image-2/gpt-image-2-6.md)
>
> SVG、GIF、`complexity` 与标记引导编辑的完整说明。

> [card] [怎么生成透明背景的图片](https://docs.apiyi.com/faq/image-transparent-background.md)
>
> 透明背景的参数写法、提示词要求和常见报错。

> [card] [文生图 API 参考](https://docs.apiyi.com/api-capabilities/gpt-image-2/text-to-image.md)
>
> `/v1/images/generations` 的完整字段。

> [card] [图片编辑 API 参考](https://docs.apiyi.com/api-capabilities/gpt-image-2/image-edit.md)
>
> `/v1/images/edits` 与多图编辑。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.