> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-mintlify-theme-mint.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"`<br />`"transparent"`                                                                                                                                    |
| `品質`           | 画像品質。コストと生成時間に影響します（デフォルト: `"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 | いいえ | 0〜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` でのみ使用できます。
* `seed` は現在、バックエンドで実装されていません。

## 出力

| 出力名     | 説明                                                                                | データ型  |
| ------- | --------------------------------------------------------------------------------- | ----- |
| `image` | 生成された画像（1 枚または複数枚）。返されたすべての画像は 1 つのバッチにスタックされます。各画像の寸法が異なる場合は、最初の画像に合わせてリサイズされます。 | IMAGE |

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

***

**Source fingerprint (SHA-256):** `804ea35d0e2aa0b2993a293cb10cb41e2f9c6a3732304306253f7f7b1eb59b8a`
