概要
Comfyui-Luck-gpt2.0は、コミュニティユーザーluckdvrが提供するComfyUIカスタムノードパックです。ComfyUI内からAPIYIのGPT画像モデルを直接呼び出します。このパックには現在、画像ノードが3つ、プロンプト制御ノードが3つ含まれています。
Comfyui-Luck gpt-image-2(公式):モデルのドロップダウンでgpt-image-2/gpt-image-2.5-flare/gpt-image-2.5-sunburstを選択でき、実際のsize/qualityを送信します。マスクによるインペインティングと最大16枚の参照画像に対応していますComfyui-Luck gpt-2.0 all(リバース):gpt-image-2-allを呼び出します。呼び出しごとの課金で、高速な会話形式の編集ができますComfyui-Luck gpt-image-2-vip(リバース):gpt-image-2-vipを呼び出します。呼び出しごとの課金で、Adobe経由のルートを利用します- プロンプト制御ノード:
GPT-Image-2 文生图提示词控制器(テキストから画像へのプロンプトコントローラー) /图生图提示词控制器(画像から画像へのプロンプトコントローラー) /文本停留编辑器(テキスト一時停止エディター)。マルチモーダルモデルを使って、入力した概要を構造化された画像プロンプトに変換できます。また、ワークフローを一時停止して手動で編集することもできます
gpt-image-2.5-flare(速度優先)とgpt-image-2.5-sunburst(品質と編集精度優先)が追加され、qualityは6段階になりました(新たにxhigh / maxが追加)。ノード名、ID、ウィジェットの順序、デフォルトモデルgpt-image-2に変更はないため、既存のワークフローでモデルや品質が自動的に切り替わることはありません。プラグインを更新した後、model (模型)のドロップダウンでモデルを選択してください。詳しくは、以下の「ノードでGPT-Image 2.5を使う」をご覧ください。- 🔗 ソース:
github.com/luckdvr/Comfyui-Luck-gpt2.0 - 📜 ライセンス:Apache-2.0
- 👤 作者:luckdvr
- ⭐ APIYI向けに開発されたコミュニティ提供のノードです。APIの動作変更やノードエラーは、まずリポジトリのIssuesに報告してください
コア機能
3ノード、3つのルート
gpt-image-2、リバースgpt-2.0 all、リバースgpt-image-2-vipがそれぞれ1つのルートをカバーします。予算と用途に応じて選択できますGPT-Image 2.5のツインモデル
gpt-image-2.5-flare / gpt-image-2.5-sunburstに切り替えられます。バージョン固定用に、-2026-09-08の日付付きスナップショットも掲載しています6段階の品質ティア
qualityはauto / low / medium / high / xhigh / maxに対応します。xhigh / maxは2つの2.5モデルのみで使用できます最大16枚の参照画像
image_01 … image_16を受け付けます。2つのリバースノードは最大14枚に対応し、複数画像の融合やスタイル転送に利用できますマスクインペインティング
mask入力は編集領域を正確に指定します(透明部分は再描画され、不透明部分は保持されます)実解像度+カスタムサイズ
プロンプトコントローラー
gemini-3.5-flashは、テキストの概要または最大5枚の参照画像を構造化された画像プロンプトに変換します。手動編集のために任意で一時停止することもできます組み込みのタイムアウトとリトライ
408 / 429 / 5xxはretry_timesに従ってリトライするため、ピーク時間帯の遅延にも対応できますサポートされている APIYI モデル
gpt-image-2-all 1画像あたり $0.025、gpt-image-2-vip 1画像あたり $0.03。公式とリバースの詳細な内訳については、gpt-image-2.5 / 2 公式 vs リバースの比較をご覧ください。ノードで GPT-Image 2.5 を使用する
プラグインを更新し、ComfyUI を完全に再起動してから、Comfyui-Luck gpt-image-2 の model (模型) ドロップダウンを切り替えます。それ以外のウィジェットはすべて同じままです。2.5 の両モデルは、テキストから画像、画像編集、16 枚の参照画像、マスクをサポートしています。ノードは、mode と参照画像が接続されているかどうかに基づいて、生成または編集のエンドポイントを選択します。
- サイレントなダウングレードなし:旧
gpt-image-2でxhigh/maxを選択した場合、または無効なモデル / 品質を指定した場合、ノードは送信前にエラーを発生させます。ティアが自動的に置き換えられることはありません autoは慎重に使用:autoは動的な推論ティアであるため、同じ prompt でもコストとレイテンシーがティア間で変動します。支出を管理するには、ティアを明示的に選択してください- 本番環境では日付付きスナップショットを固定:ドロップダウンの
gpt-image-2.5-flare-2026-09-08/gpt-image-2.5-sunburst-2026-09-08はモデルのバージョンを固定するため、上流でエイリアスが変更されてもモデルが変わることはありません - 600 秒のタイムアウトを維持:2.5 の
xhigh/max、2K / 4K、または複雑な編集では、デフォルト値を維持するか、値を引き上げてください。クライアントがタイムアウトした後も同期リクエストに課金される場合があり、自動リトライによってコストが増える可能性があります。リトライを望まない場合は、retry_timesを1に設定してください
ノードパラメータ
Comfyui-Luck gpt-image-2(公式)
パネル上のウィジェットラベルにはapi_key (API密钥)のような中国語の接尾辞が付いていますが、以下の表には英語のフィールド名のみを記載しています。
custom_sizeに関する4つの制約:いずれの辺も3840px以下、幅と高さはともに16の倍数、長辺 / 短辺比は最大3:1、総ピクセル数は655,360〜8,294,400の範囲内。比率1:4 / 4:1 / 1:8 / 8:1は公式の3:1の制限を超えているため、ノードはこれらを最も近い有効な境界サイズにスナップします。4K + 1:1では、3840x3840が総ピクセル数の上限を超えるため、2880x2880が使用されます。
background / moderation / response_format / input_fidelityを送信しません。これらはすべてAPIのデフォルト値にフォールバックします。透過背景などのオプションを利用する場合はAPIを直接呼び出してください(透過にはgpt-image-2.5-flare / gpt-image-2.5-sunburstが必要です。OpenAIは2026-09-30にgpt-image-2向けのサポートを終了しました)。詳細は透過背景のFAQを参照してください。Comfyui-Luck gpt-2.0 all(逆引き)
gpt-image-2-allはsize/quality/n/aspect_ratio APIフィールドを受け付けず、ノードから送信されることもありません。2K/4Kは、ピクセル数の保証なしでプロンプトに記述することしかできません。urlの出力は通常、約1日間有効な一時的なCDNリンクであるため、長期的に使用する必要がある場合は再ホスティングしてください。
Comfyui-Luck gpt-image-2-vip(リバース)
gpt-2.0 allと同じウィジェットに、2つのサイズ制御を追加したものです。
sizeが無効化されたというAPIYIの2026-06-23付けの告知に基づいて作成されたため、デフォルトではsizeを送信しません。APIYI側では、gpt-image-2-vipに対するsizeが2026-07-22に復元されました(一般的な30種類のサイズについては、gpt-image-2-vipドキュメントを参照してください)が、プラグインはまだ対応できていません。現在ComfyUI内で実際の出力サイズを固定するには、公式ノードComfyui-Luck gpt-image-2を使用してください。リバースb64_jsonにはdata:image/png;base64,プレフィックスが含まれており、ノードが自動的にデコードします。prompt 制御ノード
- どちらのコントローラーも APIYI
POST /v1/chat/completionsを呼び出します。モデルのドロップダウンではgemini-3.5-flash/gpt-5.5/gpt-4o/gpt-4.1-mini/gemini-2.5-flash/gemini-2.5-proを選択できます - 画像間コントローラーは画像理解と prompt の強化のみを行います。実際の複数画像参照や融合を行う場合は、同じ画像を下流の画像ノードにも接続してください
- 一時停止エディターの
edited_textは、画像ノードのprompt用の単一文字列です。edited_textsはバッチテキストワークフロー用に予約されたリスト出力です。一時停止後は、ノード上のContinueをクリックしてください。メインの「実行」ボタンを再度押さないでください。押すと ComfyUI がキューに再追加し、上流の prompt 強化を再実行します
インストール
ステップ1:custom_nodes へのクローン
git pull することで 2.5 のサポートを取得できます。ステップ2:依存関係のインストール
ステップ3:ComfyUI の完全な再起動
Comfyui-Luck を検索すると、3つの画像ノードと3つの prompt ノードが見つかります。フロントエンドのリロードだけでは不十分です。プラグインの更新後はプロセスを再起動してください。ステップ4:APIYI キーとドメインの設定
- APIYI コンソール → Tokens にアクセスし、キーを作成します(使用量上限の設定を推奨します)
- ノードの
api_keyフィールドに貼り付けます api_baseを1つ選択します:https://api.apiyi.com/v1(プライマリ)/https://b.apiyi.com/v1(中国本土向けバックアップ)。ノードは/v1の有無に関係なくベース URL を受け入れます
ステップ5:サンプルワークフローのインポート
example_workflow.json:画像ノードごとに1つのサンプル(公式版はsize=2048x1152+quality=high+jpegを使用)、選択方法を説明する中国語の Note ノード付きexample_workflow_gpt_image_2_5.json:スタンドアロンの 2.5 サンプル。Flare text-to-image → Sunburst 編集 → プレビューの構成で、デフォルトは1K + 1:1、quality=high、600秒のタイムアウトおよびretry_times=1です
使用例
例1:2.5 Flare 4K 高品質なテキスト画像生成
max は、旧 gpt-image-2 high と同じ token 予算を持つ 2.5 ティアです。より高速かつ低コストで利用したい場合は、まず high または xhigh をお試しください。
例2:2.5 Sunburst マスクインペインティング
例3:Flare のテキスト画像生成 → Sunburst 編集チェーン
リポジトリ内のexample_workflow_gpt_image_2_5.json に一致します。
例4:逆向き会話画像
例5:プロンプトコントローラー → 一時停止して編集 → 生成
PreviewImage / SaveImage で実行をキューに追加します。フローが一時停止エディターで停止したら、テキストを編集し、ノード上の Continue をクリックします。固定する必要がある対象が1枚の画像に含まれている場合は、その画像をコントローラーの subject_image にも接続し、画像ノードの image_01 に配置します。
よくある質問
3つの画像ノードのうち、どれを選ぶべきですか?
3つの画像ノードのうち、どれを選ぶべきですか?
Comfyui-Luck gpt-image-2(公式): リアルなsize/quality、ネイティブマスク、最大16枚の参照画像、token単位の課金。正確なサイズ、部分編集、または2.5の6段階の品質ティアが必要な場合に選択してください。テキストからの画像生成にはデフォルトでgpt-image-2.5-flareを、編集にはgpt-image-2.5-sunburstを使用しますComfyui-Luck gpt-2.0 all(リバース): 呼び出しごとの課金(1画像あたり$0.025)、約30〜60秒、ChatGPT Webルート。厳密なサイズ制御が不要で、反復的な編集や強力なテキスト描画が必要な場合に選択してくださいComfyui-Luck gpt-image-2-vip(リバース): 呼び出しごとの課金(1画像あたり$0.03)、約90〜150秒、Adobeルート。手元に確保しておく2つ目のリバースルートです。プラグインは現在sizeを送信しません- 完全な比較: 公式 vs リバース
プラグインの更新後、既存のワークフローは2.5に切り替わりますか?
プラグインの更新後、既存のワークフローは2.5に切り替わりますか?
gpt-image-2は変更されないため、既存のワークフローは元の品質のままgpt-image-2を実行し続けます。2.5を使用するには、model (模型)ドロップダウンを手動で切り替え、上記の表を参考にしてqualityを再度選択してください。同じhighのままで2.5に切り替えた後、なぜ安くなり、ぼやけてしまうのですか?
同じhighのままで2.5に切り替えた後、なぜ安くなり、ぼやけてしまうのですか?
highはgpt-image-2 highの約4分の1のtokenを出力し、以前のmediumに相当します。2.5で以前のhighの予算感を得るには、maxを選択してください。逆に、同じ予算であれば、2.5にはより安価な中間ティアとしてhigh / xhighが追加されています。本番環境に導入する前に、ティアごとにプロンプトを1回実行してusage.output_tokensを比較してください。プラグインはgpt-image-2.5-all / gpt-image-2.5-vipをサポートしていますか?
プラグインはgpt-image-2.5-all / gpt-image-2.5-vipをサポートしていますか?
gpt-image-2-allとgpt-image-2-vipのみがリストされています。gpt-image-2-allの背後にあるChatGPT WebアプリはImages 2.5にアップグレードされているため、そのモデルはすでに2.5の画像を生成し、gpt-image-2.5-allと同じ動作およびコストになります。gpt-image-2.5-all ドキュメントを参照してください。gpt-image-2.5-flare-vip / gpt-image-2.5-sunburst-vipはノードのドロップダウンにはまだ含まれていません。必要な場合はAPIを直接呼び出してください。インストール後にノードが見つかりませんか?
インストール後にノードが見つかりませんか?
- フォルダが
ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0にあることを確認します pip install -r requirements.txtがエラーなしで完了したことを確認します- ComfyUIを完全に再起動します(フロントエンドの更新だけでは不十分です)
4K、xhigh / max、またはカスタムサイズで頻繁にタイムアウトが発生しますか?
4K、xhigh / max、またはカスタムサイズで頻繁にタイムアウトが発生しますか?
- 公式ノードの読み取りタイムアウトのデフォルトは600秒です。2.5の
xhigh/maxおよび2K / 4Kでは、そのまま維持するか引き上げてください。408 Timeoutは通常、ノードのパラメータの誤りではなく、プロバイダー側の生成タスクがタイムアウトしたことを意味します - 同期リクエストは、クライアント側でタイムアウトした後でも課金される場合があり、自動リトライによって追加コストが発生する可能性があります。リトライを無効にするには、
retry_timesを1に設定してください - サーバーネットワークが遅い場合は、CDN経由の画像/動画のダウンロードが遅いを参照してください
- デフォルトのドメインが不安定な場合は、
api_baseをb.apiyi.com/v1に切り替えてください
以前のワークフローを読み込むと「Value 3 smaller than min of 30」と表示されますか?
以前のワークフローを読み込むと「Value 3 smaller than min of 30」と表示されますか?
retry_times=3がtimeout_seconds=3として読み込まれました。リポジトリから最新のexample_workflow.jsonを使用するか、ノードを削除して再度追加してください。pause editorの接続後、gpt-image-2で「Value not in list」と表示されますか?
pause editorの接続後、gpt-image-2で「Value not in list」と表示されますか?
promptを入力ソケットに変換すると、以前のワークフローでプロンプトのプレースホルダーが1つ不足するため、それ以降のウィジェットが1つずつずれます(例: modeがgpt-image-2を読み込み、api_baseが2Kを読み込む)。現在のノードは検証をパスし、実行時にずれた値を復元します。パネルに依然としてずれて表示される場合は、現在のワークフローを再読み込みするか、Comfyui-Luck gpt-image-2を再度追加してください。リバースノードからのb64_jsonにプレフィックスが付いて返されますか?
リバースノードからのb64_jsonにプレフィックスが付いて返されますか?
gpt-image-2-all / gpt-image-2-vipはdata:image/png;base64,プレフィックス付きでb64_jsonを返しますが、公式のgpt-image-2系はプレフィックスを付けません。3つのノードはすべて両方の形式を自動的にデコードするため、出力を直接PreviewImageに接続してください。詳細は公式 vs リバースの比較を参照してください。呼び出しで401 / 403が返されますか?
呼び出しで401 / 403が返されますか?
api_keyの有効性と、グループによって制限されていないか確認してください- 選択したモデルがtokenのホワイトリストに含まれていることを確認してください
- 残高の問題: 残高は十分にあるように見えるが呼び出しが失敗するを参照してください