OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

このノードは、OpenAI の GPT Image API を使用して画像を生成します。複数のモデル（gpt-image-2、gpt-image-1.5、gpt-image-1）をサポートし、編集用の参照画像を提供したり、マスクを使用して画像のどの部分を変更するかを指定したりできます。

入力

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

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

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

これらの入力は、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	任意	1〜16
`model.mask`	インペインティング用のオプションのマスクです（白い部分が置き換えられます）。参照画像が正確に 1 枚必要です。	MASK	任意	N/A

パラメータの制約と制限事項:

model.size が “Custom”（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 に送信される前に縮小されます。
seed は現在バックエンドで実装されていません。

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

このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ GitHub で編集

Source fingerprint (SHA-256): fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0