> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

> このノードは、OpenAI の GPT Image API を使用して画像を生成します。

このノードは、OpenAI の GPT Image API を使用して画像を生成します。`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2`、`gpt-image-1.5`、`gpt-image-1` の5つのモデルに対応しており、画像編集用の参照画像を添付したり、マスクを使用して画像の置き換える部分を指定したりできます。

## 入力

### 共通入力

これらの入力は常に表示されます。

| パラメータ   | 説明                                                          | データ型           | 必須 | 範囲                                                                                                                       |
| ------- | ----------------------------------------------------------- | -------------- | -- | ------------------------------------------------------------------------------------------------------------------------ |
| `モデル`   | 使用する OpenAI GPT Image モデル。モデルを選択すると、そのモデル固有の追加パラメータが表示されます。 | DYNAMIC\_COMBO | はい | `"gpt-image-2.5-flare"`<br />`"gpt-image-2.5-sunburst"`<br />`"gpt-image-2"`<br />`"gpt-image-1.5"`<br />`"gpt-image-1"` |
| `プロンプト` | GPT Image 用のテキストプロンプト（デフォルト: `""`）。                         | STRING         | はい | N/A                                                                                                                      |
| `n`     | 生成する画像の枚数（デフォルト: `1`）。                                      | INT            | はい | 1〜8                                                                                                                      |
| `シード`   | 再現性のためのシード値（デフォルト: `0`）。バックエンドではまだ実装されていません。                | INT            | はい | 0〜2147483647                                                                                                             |

### gpt-image-2.5-flare および gpt-image-2.5-sunburst 入力

これらの入力は、`model` が `gpt-image-2.5-flare` または `gpt-image-2.5-sunburst` に設定されている場合に表示されます。両モデルは同じパラメータセットを共有します。

| パラメータ          | 説明                                                                   | データ型  | 必須  | 範囲                                                                                                                                                                               |
| -------------- | -------------------------------------------------------------------- | ----- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `サイズ`          | 画像サイズ。「Custom」を選択すると、カスタムの幅と高さを使用できます（デフォルト: `"auto"`）。              | COMBO | はい  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"`<br />`"2048x2048"`<br />`"2048x1152"`<br />`"1152x2048"`<br />`"3840x2160"`<br />`"2160x3840"`<br />`"Custom"` |
| `カスタム幅`        | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります（デフォルト: `1024`）。 | INT   | いいえ | 480〜3840 (ステップ 16)                                                                                                                                                               |
| `カスタム高さ`       | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります（デフォルト: `1024`）。 | INT   | いいえ | 480〜3840 (ステップ 16)                                                                                                                                                               |
| `背景`           | 背景あり・なしの画像を返します（デフォルト: `"auto"`）。                                    | COMBO | はい  | `"auto"`<br />`"opaque"`<br />`"transparent"`                                                                                                                                    |
| `品質`           | 画像品質。コストと生成時間に影響します（デフォルト: `"low"`）。                                 | COMBO | はい  | `"low"`<br />`"medium"`<br />`"high"`<br />`"xhigh"`<br />`"max"`                                                                                                                |
| `model.images` | 画像編集用のオプションの参照画像（複数可）。最大16枚。詳細は「参照入力」を参照してください。                      | IMAGE | いいえ | 0〜16                                                                                                                                                                             |
| `model.mask`   | インペインティング用のオプションのマスク（白い領域が置き換えられます）。参照画像が正確に1枚必要です。                  | MASK  | いいえ | N/A                                                                                                                                                                              |

### gpt-image-2 入力

これらの入力は、`model` が `gpt-image-2` に設定されている場合に表示されます。

| パラメータ          | 説明                                                                   | データ型  | 必須  | 範囲                                                                                                                                                                               |
| -------------- | -------------------------------------------------------------------- | ----- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `サイズ`          | 画像サイズ。「Custom」を選択すると、カスタムの幅と高さを使用できます（デフォルト: `"auto"`）。              | COMBO | はい  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"`<br />`"2048x2048"`<br />`"2048x1152"`<br />`"1152x2048"`<br />`"3840x2160"`<br />`"2160x3840"`<br />`"Custom"` |
| `カスタム幅`        | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります（デフォルト: `1024`）。 | INT   | いいえ | 480〜3840 (ステップ 16)                                                                                                                                                               |
| `カスタム高さ`       | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります（デフォルト: `1024`）。 | INT   | いいえ | 480〜3840 (ステップ 16)                                                                                                                                                               |
| `背景`           | 背景あり・なしの画像を返します（デフォルト: `"auto"`）。                                    | COMBO | はい  | `"auto"`<br />`"opaque"`                                                                                                                                                         |
| `品質`           | 画像品質。コストと生成時間に影響します（デフォルト: `"low"`）。                                 | COMBO | はい  | `"low"`<br />`"medium"`<br />`"high"`                                                                                                                                            |
| `model.images` | 画像編集用のオプションの参照画像（複数可）。最大16枚。詳細は「参照入力」を参照してください。                      | IMAGE | いいえ | 0〜16                                                                                                                                                                             |
| `model.mask`   | インペインティング用のオプションのマスク（白い領域が置き換えられます）。参照画像が正確に1枚必要です。                  | MASK  | いいえ | N/A                                                                                                                                                                              |

### gpt-image-1.5 および gpt-image-1 入力

これらの入力は、`model` が `gpt-image-1.5` または `gpt-image-1` に設定されている場合に表示されます。両モデルは同じパラメータセットを共有します。

| パラメータ          | 説明                                                  | データ型  | 必須  | 範囲                                                                |
| -------------- | --------------------------------------------------- | ----- | --- | ----------------------------------------------------------------- |
| `サイズ`          | 画像サイズ（デフォルト: `"auto"`）。                             | COMBO | はい  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"` |
| `背景`           | 背景あり・なしの画像を返します（デフォルト: `"auto"`）。                   | COMBO | はい  | `"auto"`<br />`"opaque"`<br />`"transparent"`                     |
| `品質`           | 画像品質。コストと生成時間に影響します（デフォルト: `"low"`）。                | COMBO | はい  | `"low"`<br />`"medium"`<br />`"high"`                             |
| `model.images` | 画像編集用のオプションの参照画像（複数可）。最大16枚。詳細は「参照入力」を参照してください。     | IMAGE | いいえ | 0〜16                                                              |
| `model.mask`   | インペインティング用のオプションのマスク（白い領域が置き換えられます）。参照画像が正確に1枚必要です。 | MASK  | いいえ | N/A                                                               |

### 参照入力

| パラメータ          | 説明                                                                               | データ型  | 必須  | 範囲   |
| -------------- | -------------------------------------------------------------------------------- | ----- | --- | ---- |
| `model.images` | 拡張可能スロット: 1..N 個の項目を接続できます（例: `image_1`...`image_16`）。すべてのモデルで最大16枚の参照画像を使用できます。 | IMAGE | いいえ | 1〜16 |
| `model.mask`   | インペインティング用のオプションのマスク（白い領域が置き換えられます）。参照画像が正確に1枚必要です。                              | MASK  | いいえ | N/A  |

**パラメータの制約と制限：**

* `model.size` が "Custom" の場合（`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、および `gpt-image-2` のみ）、`model.custom_width` と `model.custom_height` は両方とも16の倍数である必要があります。最長辺は3840を超えてはならず、アスペクト比は3:1を超えてはならず、総ピクセル数は655,360〜8,294,400の範囲内である必要があります。
* `model.mask` を使用するには、`model.images` に参照画像が正確に1枚含まれている必要があります。画像なしでは使用できず、また複数の画像と一緒にも使用できません。
* `model.mask` を使用する場合、その高さと幅は参照画像の高さと幅と一致している必要があります。
* `model.images` が指定された場合、ノードは画像編集モードで動作します。`model.images` がない場合は、プロンプトのみから画像を生成します。
* 参照画像とマスクは、API に送信される前にダウンスケールされます。
* `"xhigh"` および `"max"` の品質レベルは、`gpt-image-2.5-flare` と `gpt-image-2.5-sunburst` でのみ利用できます。
* `"transparent"` 背景オプションは、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-1.5`、`gpt-image-1` で利用できますが、`gpt-image-2` では利用できません。
* `seed` は現在バックエンドで実装されていません。

## 出力

| 出力名     | 説明                                                            | データ型  |
| ------- | ------------------------------------------------------------- | ----- |
| `image` | 生成された画像。返されたすべての画像は1つのバッチにまとめられ、サイズが異なる場合は最初の画像に合わせてリサイズされます。 | IMAGE |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md)

***

**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148`