> ## 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）では、透明背景と jpeg の組み合わせのみ 400 エラーが返されます。gif は 1-bit 透過に対応し、svg では背景に不透明色が必要です。

> [!NOTE]
>
> このページは、2つの **GPT Image 2.6 公式リレー** モデルに適用されます：`gpt-image-2.6-sunburst`（精密な作業向け）および `gpt-image-2.6-flare`（高速な反復向け）。GPT Image 2.5 / 2 は gif または svg 出力に対応していないため、これらのルールを直接適用しないでください。

## 短い回答

唯一のハードな競合は、`background: "transparent"` と `output_format: "jpeg"` を併用できないことです。併用すると 400 が返されます。それ以外の組み合わせはすべて動作しますが、透明度の扱いは異なります。

| `background` | `png` | `jpeg` | `webp` | `gif` | `svg` |
| - | - | - | - | - | - |
| `transparent` | ✅ 完全なアルファ | ❌ 400 | ✅ 完全なアルファ | ✅ 1ビットの透明度 | ✅ 背景なし |
| `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 にはアルファチャンネルがないため、`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ビットアルファのみです

`output_format: "gif"` + `background: "transparent"` は2.6で、テキストから画像への生成と画像編集の両方に対応しています。テストでは、フレームの46%～60%が透明ピクセルで覆われていましたが、`opaque` では0%でした。

GIFの透明度はパレットベースです。ピクセルは完全に透明または完全に不透明のいずれかで、滑らかなアルファエッジはありません。エッジの品質が重要な場合は、`png` / `webp` を使用してください。これはGIF出力に対応する2.6にのみ適用されます。2.5以前はGIF出力に対応していません。

## SVGにはアルファチャンネルがなく、`opaque`が背景を追加します

SVGはアルファチャンネルを持たないベクター形式で、デフォルトでは透明です。

* `transparent`: 背景の長方形は書き込まれません。
* `opaque`: キャンバス全体を覆う白い長方形が追加されます（例: `<rect width="1024" height="1024" fill="#fff" />`）。
* `auto`: どちらのテストでも、`auto`は背景を書き込まなかったため、`opaque`として扱わないでください。白い背景が必要な場合は、`opaque`を明示的に渡してください。

> [!NOTE]
>
> `output_format: "svg"`はテキストから画像を生成するエンドポイントでのみサポートされ、`n: 1`が必要で、`svg.model`も必要です。最終的な背景のマークアップは作成モデルが決めるため、`svg.model`を変更した後は実際のファイルを再確認してください。

## `auto`は`opaque`に固定されません

`background`を省略した場合、デフォルトは`auto`です。`auto`は常に単色の背景を生成するのではなく、promptに従います。

* 無地の白い背景を要求するpromptでは、`png` / `jpeg` / `gif`は`opaque`を報告し、アルファチャンネルはありませんでした。
* 背景なしで被写体を切り抜くよう要求するpromptでは、`png` / `webp` / `gif` / `svg`は`transparent`を報告し、最初の3つには実際に透明なピクセルがありました。
* `jpeg`の場合、`auto`は強制的に`opaque`に設定され、エラーは発生しません。

出力を確定的にするには、`auto`に依存せず、`transparent`または`opaque`を明示的に指定してください。

## 関連する2つのフォーマット制約

* `output_compression` は `jpeg` / `webp` にのみ適用されます。
* `frame_count` / `frame_duration_ms` は `gif` 専用です。PNG、JPEG、WebP、SVG には送信しないでください。

## 関連ドキュメント

> [card] [GPT Image 2.6の機能](https://docs.apiyi.com/ja/api-capabilities/gpt-image-2/gpt-image-2-6.md)
>
> SVG、GIF、`complexity`、マークアップに基づく編集を、実際の結果とともに紹介します。

> [card] [透過画像の生成方法](https://docs.apiyi.com/ja/faq/image-transparent-background.md)
>
> 透過背景に関するパラメータの形式、promptの要件、よくあるエラーを説明します。

> [card] [テキストからの画像生成APIリファレンス](https://docs.apiyi.com/ja/api-capabilities/gpt-image-2/text-to-image.md)
>
> `/v1/images/generations`のすべてのフィールドを説明します。

> [card] [画像編集APIリファレンス](https://docs.apiyi.com/ja/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.