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" "gpt-image-2.5-sunburst" "gpt-image-2" "gpt-image-1.5" "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" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
カスタム幅	model.size が "Custom" の場合にのみ使用されます。16 の倍数である必要があります（デフォルト: 1024）。	INT	いいえ	480〜3840 (ステップ 16)
カスタム高さ	model.size が "Custom" の場合にのみ使用されます。16 の倍数である必要があります（デフォルト: 1024）。	INT	いいえ	480〜3840 (ステップ 16)
背景	背景ありまたは背景なしで画像を返します（デフォルト: "auto"）。	COMBO	はい	"auto" "opaque" "transparent"
品質	画像品質。コストと生成時間に影響します（デフォルト: "low"）。	COMBO	はい	"low" "medium" "high" "xhigh" "max"
model.images	画像編集用のオプションの参照画像。最大 16 枚。詳細は「参照入力」を参照してください。	IMAGE	いいえ	0〜16
model.mask	インペインティング用のオプションのマスク（白い領域が置き換えられます）。参照画像がちょうど 1 枚必要です。	MASK	いいえ	N/A

​

gpt-image-2 入力

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

パラメータ	説明	データ型	必須	範囲
サイズ	画像サイズ。"Custom" を選択すると、カスタム幅と高さを使用します（デフォルト: "auto"）。	COMBO	はい	"auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
カスタム幅	model.size が "Custom" の場合にのみ使用されます。16 の倍数である必要があります（デフォルト: 1024）。	INT	いいえ	480〜3840 (ステップ 16)
カスタム高さ	model.size が "Custom" の場合にのみ使用されます。16 の倍数である必要があります（デフォルト: 1024）。	INT	いいえ	480〜3840 (ステップ 16)
背景	背景ありまたは背景なしで画像を返します（デフォルト: "auto"）。	COMBO	はい	"auto" "opaque" "transparent"
品質	画像品質。コストと生成時間に影響します（デフォルト: "low"）。	COMBO	はい	"low" "medium" "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" "1024x1024" "1024x1536" "1536x1024"
背景	背景ありまたは背景なしで画像を返します（デフォルト: "auto"）。	COMBO	はい	"auto" "opaque" "transparent"
品質	画像品質。コストと生成時間に影響します（デフォルト: "low"）。	COMBO	はい	"low" "medium" "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 で編集

---

Source fingerprint (SHA-256): 804ea35d0e2aa0b2993a293cb10cb41e2f9c6a3732304306253f7f7b1eb59b8a