> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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 | いいえ | 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):** `9cf1a9fa3e2cd98aff6c42432164ac5e6c55b7bcdc9815043cb359c6968ac172`


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