Luck GPT-Image 2 - ComfyUI ノード

概要

Comfyui-Luck-gpt2.0 は、コミュニティユーザー luckdvr が提供した ComfyUI のカスタムノードパックです。APIYI の 2 つの GPT 画像モデルを ComfyUI 内から直接呼び出せます。公式 gpt-image-2 と 逆解析版 gpt-image-2-all です。2 つのノードは役割分担が明確で、前者はきめ細かなパラメータ（解像度、品質、マスク、複数参照）に重点を置き、後者は ChatGPT と同等の会話型画像体験を提供し、タイムアウト／リトライを内蔵しています。制作ワークフローに最適です。

プロジェクト情報

🔗 ソース: github.com/luckdvr/Comfyui-Luck-gpt2.0
📜 ライセンス: Apache-2.0
👤 作者: luckdvr
⭐ コミュニティによる提供、APIYI 向けに構築

作者の別のノードパックとどう見分ければよいですか？luckdvr は APIYI 向けに 2 つの ComfyUI ノードパックを提供しています。

Luck Nano Banana Pro: Gemini 系列（gemini-3-pro-image-preview / gemini-3.1-flash-image-preview）を呼び出します。14 枚の参照画像と、エンタープライズ級のリトライ／タイムアウトを重視しています
Luck GPT-Image 2（このページ）: OpenAI 系列（gpt-image-2 / gpt-image-2-all）を呼び出します。二重エンドポイント切り替え（chat_completions / images_api）とマスクのインペインティングを重視しています

主な機能

2つのノード、2つのルート

Comfyui-Luck gpt-image-2（公式）とComfyui-Luck gpt-2.0 all（リバース）— シーンに合うほうを選べます

最大5枚の参照画像

公式ノードは、複雑な融合やスタイル転送のために最大5枚の参照画像を受け付けます

マスクインペインティング

ローカルな変更のために、編集領域を正確に指定できる任意のマスク入力

複数段階 + カスタム解像度

1K / 2K / 4K のプリセットに加え、カスタムサイズ指定も可能です（各辺最大 3840px、総ピクセル数 655,360–8,294,400）

15種類のアスペクト比

AUTO, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1

品質と出力形式

quality（auto / low / medium / high）+ 出力形式（png / jpeg / webp）+ 圧縮率 0-100

デュアルエンドポイント（リバースノード）

gpt-image-2-allはchat_completionsとimages_apiのエンドポイントを切り替えできます

タイムアウトとリトライを内蔵

タイムアウトとリトライのパラメータを標準搭載 — ピーク時間帯でも安定しています

APIYI 対応モデル

モデル	Model ID	ノード	用途	API ドキュメント
GPT-Image 2 （公式）	`gpt-image-2`	`Comfyui-Luck gpt-image-2`	ネイティブな 2K/4K テキストから画像生成、参照画像編集、マスクインペインティング	表示
GPT-Image 2 All （リバース）	`gpt-image-2-all`	`Comfyui-Luck gpt-2.0 all`	ChatGPT 同等の対話型画像生成、呼び出しごとの課金	表示

完全な並列表は、gpt-image-2 (公式) vs gpt-image-2-all (リバース) の比較をご覧ください。

ノードパラメーター

`Comfyui-Luck gpt-image-2` (公式)

パラメーター	型	必須	デフォルト	説明
`api_key`	string	Yes	-	APIYI token — 使用上限付きの専用キーを推奨します
`prompt`	string	Yes	-	生成または編集の指示
`image_1` … `image_5`	IMAGE	No	-	参照画像、最大5枚
`mask`	MASK	No	-	インペインティング用の任意マスク（白い領域 = 編集領域）
`size`	enum	No	`2K`	出力解像度（1K / 2K / 4K / custom）
`custom_size`	string	No	-	`size` が `custom` のときに使用します。例: `2048x3072`
`aspect_ratio`	enum	No	`AUTO`	15 種類のアスペクト比のいずれか
`quality`	enum	No	`auto`	auto / low / medium / high
`output_format`	enum	No	`png`	png / jpeg / webp
`output_compression`	int	No	80	0-100（jpeg / webp のみに適用）

`Comfyui-Luck gpt-2.0 all` (逆方向)

パラメーター	型	必須	デフォルト	説明
`api_key`	string	Yes	-	APIYI token
`prompt`	string	Yes	-	対話型画像 prompt
`endpoint`	enum	No	`chat_completions`	`chat_completions` / `images_api`
`response_format`	enum	No	-	`b64_json` / `url` など
`timeout_seconds`	int	No	-	リクエストごとのタイムアウト
`retry_times`	int	No	-	失敗時のリトライ回数

インストール

手順 1: custom_nodes にクローンする

ComfyUI のインストール先で:

cd ComfyUI/custom_nodes
git clone https://github.com/luckdvr/Comfyui-Luck-gpt2.0.git

手順 2: 依存関係をインストールする

cd Comfyui-Luck-gpt2.0
python3 -m pip install -r requirements.txt

手順 3: ComfyUI を再起動する

ノードパレットで Luck gpt-image-2 または Luck gpt-2.0 all を検索して見つけてください。

手順 4: APIYI キーを設定する

APIYI コンソール → Tokens を開き、新しいキーを作成してください（安全のため使用上限を設定するのがおすすめです）
api_key フィールドに貼り付けてください
ノードの既定値は api.apiyi.com です。必要に応じて予備ドメイン vip.apiyi.com / b.apiyi.com に切り替えられます

手順 5: サンプルワークフローをインポートする

リポジトリには example_workflow.json が同梱されています。開始点として ComfyUI にインポートしてください。

使用例

例1: 公式の4K高品質テキストから画像生成

Node: Comfyui-Luck gpt-image-2
prompt: "Cinematic portrait of a samurai in a misty bamboo forest, volumetric light, 85mm lens, photorealistic"
size: 4K
aspect_ratio: 2:3
quality: high
output_format: png

例2: マスクインペインティング（公式）

Node: Comfyui-Luck gpt-image-2
image_1: original photo
mask: the area to be replaced (white = edit region)
prompt: "replace the sky with dramatic sunset clouds, keep everything else intact"
size: 2K
quality: high

例3: 逆対話画像

Node: Comfyui-Luck gpt-2.0 all
endpoint: chat_completions
prompt: "A girl in hanfu standing under a cherry blossom tree, watercolor style, soft lighting"
response_format: b64_json
timeout_seconds: 180
retry_times: 3

よくある質問

どのノードを選べばよいですか？

gpt-image-2（公式）: 制御可能なパラメータ、ネイティブのマスク対応、token ごとの課金、きめ細かな解像度/品質 — 特定のサイズ要件がある場合やローカル編集が必要な場合に最適です
gpt-image-2-all（リバース）: 呼び出しごとの課金（$0.03/call）、会話形式の自然言語 prompt、ChatGPT の Web 体験との同等性 — 反復編集や優れたテキスト描画に最適です
詳細な並列表: 公式版とリバース版の比較

インストール後にノードが見つかりませんか？

フォルダが ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0 にあることを確認してください
pip install -r requirements.txt がエラーなく完了したことを確認してください
ComfyUI を完全に再起動してください（フロントエンドを更新するだけでは不十分です）

4K やカスタムサイズでタイムアウトが頻発しますか？

リバースノードの timeout_seconds を上げてください
サーバーのネットワークが遅い場合は、CDN の画像/動画ダウンロードが遅いをご覧ください
既定のエンドポイントが不安定な場合は、バックアップドメイン vip.apiyi.com / b.apiyi.com に切り替えてください

b64_json にプレフィックスが付いて返ってきますか？

リバース gpt-image-2-all では b64_json が data:image/png;base64, プレフィックス付きで返りますが、公式 gpt-image-2 では返りません。詳細は公式版とリバース版の比較をご覧ください。

呼び出しで 401 / 403 が返りますか？

api_key の有効性と、チャネルによる制限の有無を確認してください
選択したモデルが token にホワイトリスト登録されていることを確認してください
残高の問題については、残高は十分そうなのに呼び出しが失敗するをご覧ください

gpt-image-2 (official) ドキュメント

ネイティブ2K/4K生成、token単位の課金

gpt-image-2-all (reverse) ドキュメント

ChatGPT互換、$0.03/回

公式版とリバース版の比較

17項目の横並び表

ComfyUIノードコレクション

APIYI向けに調整されたComfyUIノードをさらに閲覧できます

Luck Nano Banana Pro (同じ作者)

luckdvrのGemini系ComfyUIノード

APIYI GPT-Image 2 Skills (同じモデル)

同じ2つのGPT画像モデル向けのAI Agent Skill版

APIYI Console

キー、利用状況、チャネルを管理します

概要

対話AI

プログラミング

コミュニティ投稿

AIエージェント

エンジニアリング

翻訳

Luck GPT-Image 2 - ComfyUI ノード

概要

主な機能

2つのノード、2つのルート

最大5枚の参照画像

マスクインペインティング

複数段階 + カスタム解像度

15種類のアスペクト比

品質と出力形式

デュアルエンドポイント（リバースノード）

タイムアウトとリトライを内蔵

APIYI 対応モデル

ノードパラメーター

`Comfyui-Luck gpt-image-2` (公式)

`Comfyui-Luck gpt-2.0 all` (逆方向)

インストール

使用例

例1: 公式の4K高品質テキストから画像生成

例2: マスクインペインティング（公式）

例3: 逆対話画像

よくある質問

gpt-image-2 (official) ドキュメント

gpt-image-2-all (reverse) ドキュメント

公式版とリバース版の比較

ComfyUIノードコレクション

Luck Nano Banana Pro (同じ作者)

APIYI GPT-Image 2 Skills (同じモデル)

APIYI Console

​概要

​主な機能

2つのノード、2つのルート

最大5枚の参照画像

マスクインペインティング

複数段階 + カスタム解像度

15種類のアスペクト比

品質と出力形式

デュアルエンドポイント（リバースノード）

タイムアウトとリトライを内蔵

​APIYI 対応モデル

​ノードパラメーター

​Comfyui-Luck gpt-image-2 (公式)

​Comfyui-Luck gpt-2.0 all (逆方向)

​インストール

​使用例

​例1: 公式の4K高品質テキストから画像生成

​例2: マスクインペインティング（公式）

​例3: 逆対話画像

​よくある質問

​Related Resources

gpt-image-2 (official) ドキュメント

gpt-image-2-all (reverse) ドキュメント

公式版とリバース版の比較

ComfyUIノードコレクション

Luck Nano Banana Pro (同じ作者)

APIYI GPT-Image 2 Skills (同じモデル)

APIYI Console

概要

主な機能

APIYI 対応モデル

ノードパラメーター

`Comfyui-Luck gpt-image-2` (公式)

`Comfyui-Luck gpt-2.0 all` (逆方向)

インストール

使用例

例1: 公式の4K高品質テキストから画像生成

例2: マスクインペインティング（公式）

例3: 逆対話画像

よくある質問

Related Resources