Luck GPT-Image 2 - ComfyUI 節點

概述

Comfyui-Luck-gpt2.0 是社群使用者 luckdvr 貢獻的 ComfyUI 自定義節點合集，在 ComfyUI 中一鍵呼叫 API易的兩款 GPT 影像模型 —— 官轉 gpt-image-2 與 官逆 gpt-image-2-all。兩個節點分工明確：前者主打精細引數（解析度、畫質、mask、多參考圖），後者主打 ChatGPT 一致的對話式出圖體驗，配合超時重試，適合放進生產級工作流。

專案資訊

🔗 開源地址：github.com/luckdvr/Comfyui-Luck-gpt2.0
📜 許可證：Apache-2.0
👤 作者：luckdvr
⭐ 該專案由社群使用者貢獻，專為 API易適配

同一作者的兩套節點如何區分？luckdvr 為 API易貢獻了兩套 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）與 mask 重繪

核心功能

雙節點雙路線

Comfyui-Luck gpt-image-2（官轉）與 Comfyui-Luck gpt-2.0 all（官逆）各管一路，按場景自由選擇

最多 5 張參考圖

官轉節點支援最多 5 張參考圖疊加輸入，滿足複雜融合與風格遷移

Mask 局部重繪

支援可選 mask 輸入，精準圈定重繪區域，做精細化局部編輯

多檔解析度 + 自定義尺寸

1K / 2K / 4K 預設 + 自定義尺寸（單邊最大 3840px，畫素數 65.5 萬–829.4 萬）

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 端點切換，相容不同調用習慣

超時重試內建

內建超時與重試引數，應對高峰期網路抖動

支援的 API易模型

模型名稱	模型標識	對應節點	用途	API 文件
GPT-Image 2（官轉）	`gpt-image-2`	`Comfyui-Luck gpt-image-2`	原生 2K/4K 文生圖、參考圖編輯、mask 重繪	檢視文件
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	是	-	API易令牌，建議單獨建立帶用量上限的專用 Key
`prompt`	string	是	-	生成或編輯的文本指令
`image_1` … `image_5`	IMAGE	否	-	參考圖輸入，最多 5 張
`mask`	MASK	否	-	可選 mask，用於局部重繪（白色區域為編輯區）
`size`	enum	否	`2K`	輸出解析度（1K / 2K / 4K / custom）
`custom_size`	string	否	-	`size` 選 `custom` 時生效，如 `2048x3072`
`aspect_ratio`	enum	否	`AUTO`	15 種寬高比之一
`quality`	enum	否	`auto`	auto / low / medium / high
`output_format`	enum	否	`png`	png / jpeg / webp
`output_compression`	int	否	80	0-100（僅對 jpeg / webp 生效）

`Comfyui-Luck gpt-2.0 all`（官逆）

引數名	型別	必填	預設值	說明
`api_key`	string	是	-	API易令牌
`prompt`	string	是	-	對話式生圖指令
`endpoint`	enum	否	`chat_completions`	`chat_completions` / `images_api`
`response_format`	enum	否	-	`b64_json` / `url` 等
`timeout_seconds`	int	否	-	單次請求超時
`retry_times`	int	否	-	失敗重試次數

安裝配置

第一步：克隆到 custom_nodes

進入 ComfyUI 安裝目錄：

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

第二步：安裝依賴

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

第三步：重啟 ComfyUI

在節點搜尋欄輸入 Luck gpt-image-2 或 Luck gpt-2.0 all 即可找到兩個節點。

第四步：配置 API易金鑰

訪問 API易控制台 →【令牌】新建金鑰（建議配用量上限）
貼上到節點的 api_key 引數
節點預設指向 api.apiyi.com；不穩定時可切換備用域名 vip.apiyi.com / b.apiyi.com

第五步：匯入示例工作流

倉庫內提供 example_workflow.json，可直接在 ComfyUI 中匯入作為工作流起點。

使用示例

示例 1：官轉 4K 高品質文生圖

節點: 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：mask 局部重繪（官轉）

節點: Comfyui-Luck gpt-image-2
image_1: 原始照片
mask: 要替換的區域（白色為編輯區）
prompt: "replace the sky with dramatic sunset clouds, keep everything else intact"
size: 2K
quality: high

示例 3：官逆對話式出圖

節點: Comfyui-Luck gpt-2.0 all
endpoint: chat_completions
prompt: "一位穿漢服的少女站在櫻花樹下，水彩畫風格，柔和光線"
response_format: b64_json
timeout_seconds: 180
retry_times: 3

常見問題

兩個節點如何選？

gpt-image-2（官轉）：引數可控、原生支援 mask、按 token 計費、解析度 / 畫質精細可調 —— 適合有明確尺寸要求或需要局部重繪的工作流
gpt-image-2-all（官逆）：按次計費（$0.03 / 次），對話式自然語言出圖、與 ChatGPT 網頁版能力一致 —— 適合多輪改圖、文字還原要求高的場景
完整差異看官轉 vs 官逆對比文件

節點找不到？

確認目錄 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 不帶。詳細說明見官轉 vs 官逆對比文件。

呼叫返回 401 / 403？

檢查 api_key 是否正確，是否被分組限制誤攔
所選模型是否在令牌的白名單內
餘額問題參考為什麼還有餘額跑不通

gpt-image-2（官轉）文件

原生 2K/4K 高畫質生圖，按 token 計費

gpt-image-2-all（官逆）文件

ChatGPT 一致體驗，$0.03 / 次按次計費

官轉 vs 官逆對比

17 個維度一表看清兩款模型的差異

ComfyUI 節點合集

檢視更多 API易適配的 ComfyUI 節點

Luck Nano Banana Pro（同作者）

luckdvr 的 Gemini 系列 ComfyUI 節點

APIYI GPT-Image 2 Skills（同模型）

兩款 GPT 影像模型的 AI Agent Skill 封裝版本

API易控制台

管理金鑰、用量與分組

概覽

對話型 AI

程式設計開發

社群貢獻

AI Agent

技術工程

翻譯場景

Luck GPT-Image 2 - ComfyUI 節點

概述

核心功能

雙節點雙路線

最多 5 張參考圖

Mask 局部重繪

多檔解析度 + 自定義尺寸

15 種寬高比

畫質與輸出格式可選

雙端點切換（官逆節點）

超時重試內建

支援的 API易模型

節點引數

`Comfyui-Luck gpt-image-2`（官轉）

`Comfyui-Luck gpt-2.0 all`（官逆）

安裝配置

使用示例

示例 1：官轉 4K 高品質文生圖

示例 2：mask 局部重繪（官轉）

示例 3：官逆對話式出圖

常見問題

相關資源

gpt-image-2（官轉）文件

gpt-image-2-all（官逆）文件

官轉 vs 官逆對比

ComfyUI 節點合集

Luck Nano Banana Pro（同作者）

APIYI GPT-Image 2 Skills（同模型）

API易控制台

​概述

​核心功能

雙節點雙路線

最多 5 張參考圖

Mask 局部重繪

多檔解析度 + 自定義尺寸

15 種寬高比

畫質與輸出格式可選

雙端點切換（官逆節點）

超時重試內建

​支援的 API易 模型

​節點引數

​Comfyui-Luck gpt-image-2（官轉）

​Comfyui-Luck gpt-2.0 all（官逆）

​安裝配置

​使用示例

​示例 1：官轉 4K 高品質文生圖

​示例 2：mask 局部重繪（官轉）

​示例 3：官逆對話式出圖

​常見問題

​相關資源

gpt-image-2（官轉）文件

gpt-image-2-all（官逆）文件

官轉 vs 官逆 對比

ComfyUI 節點合集

Luck Nano Banana Pro（同作者）

APIYI GPT-Image 2 Skills（同模型）

API易控制台

概述

核心功能

支援的 API易模型

節點引數

`Comfyui-Luck gpt-image-2`（官轉）

`Comfyui-Luck gpt-2.0 all`（官逆）

安裝配置

使用示例

示例 1：官轉 4K 高品質文生圖

示例 2：mask 局部重繪（官轉）

示例 3：官逆對話式出圖

常見問題

相關資源

官轉 vs 官逆對比