跳轉到主要內容

概述

Comfyui-Luck-gpt2.0 是社群使用者 luckdvr 貢獻的 ComfyUI 自定義節點包,在 ComfyUI 中一鍵呼叫 API易 的 GPT 影像模型。當前包含 三個出圖節點 與 三個提示詞控制節點:
  • Comfyui-Luck gpt-image-2(官轉):模型下拉可選 gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst,真正傳 size / quality,支援 mask 局部重繪與最多 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 文生圖提示詞控制器 / 圖生圖提示詞控制器 / 文本停留編輯器,用多模態模型把需求整理成結構化出圖提示詞,並支援在工作流中途暫停手改
2026-09-10 更新:支援 GPT-Image 2.5。官轉節點新增 gpt-image-2.5-flare(速度優先)與 gpt-image-2.5-sunburst(畫質與編輯精度優先),quality 擴到六檔(新增 xhigh / max)。節點名稱、ID、控制元件順序與預設模型 gpt-image-2 都沒變,已有工作流不會自動切換模型或畫質,更新外掛後在 model (模型) 下拉里手動選即可。詳見下方「GPT-Image 2.5 在節點裡怎麼用」。
專案資訊
  • 🔗 開源地址:github.com/luckdvr/Comfyui-Luck-gpt2.0
  • 📜 許可證:Apache-2.0
  • 👤 作者:luckdvr
  • ⭐ 該專案由社群使用者貢獻,專為 API易 適配;介面行為變化或節點報錯請優先到倉庫 Issues 反饋
同一作者的兩套節點如何區分?luckdvr 為 API易 貢獻了兩套 ComfyUI 節點:
  • Luck Nano Banana Pro:呼叫 Gemini 系列(gemini-3-pro-image / gemini-3.1-flash-image),強調 14 張參考圖與工程化超時重試
  • Luck GPT-Image 2(本頁):呼叫 OpenAI 系列(gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2-all / gpt-image-2-vip),強調真實 size / quality 控制、mask 重繪與提示詞控制器

核心功能

三節點三路線

官轉 gpt-image-2、官逆 gpt-2.0 all、官逆 gpt-image-2-vip 各管一路,按預算與需求自由選擇

GPT-Image 2.5 雙子模型

官轉節點下拉切換 gpt-image-2.5-flare / gpt-image-2.5-sunburst,另提供 -2026-09-08 日期快照用於鎖定版本

六檔畫質

quality 可選 auto / low / medium / high / xhigh / max,其中 xhigh / max 僅 2.5 兩款接受

最多 16 張參考圖

官轉節點 image_01 … image_16;官逆兩節點最多 14 張,滿足多圖融合與風格遷移

Mask 局部重繪

官轉節點支援可選 mask 輸入,精準圈定重繪區域(透明區域重繪、不透明區域保留)

真實解析度 + 自定義尺寸

auto / 1K / 2K / 4K 預設 + 自定義尺寸(單邊最大 3840px,畫素數 65.5 萬–829.4 萬)

提示詞控制器

預設用 gemini-3.5-flash 把文字需求或最多 5 張參考圖整理成結構化出圖提示詞,可在中途暫停手改

超時重試內建

官轉節點預設 600 秒超時;408 / 429 / 5xx 按 retry_times 自動重試,應對高峰期抖動

支援的 API易 模型

三款官轉模型同價同參數,按 token 計費;兩款官逆按次計費:gpt-image-2-all $0.025 / 張、gpt-image-2-vip $0.03 / 張。官轉與官逆的完整差異見 gpt-image-2.5 / 2 官轉 vs 官逆 對比文件。

GPT-Image 2.5 在節點裡怎麼用

更新外掛並完全重啟 ComfyUI 後,在 Comfyui-Luck gpt-image-2 節點的 model (模型) 下拉框切換即可,其餘控制元件不變。兩款 2.5 都支援文生圖、圖片編輯、16 張參考圖和 mask;節點按 mode 與是否接入參考圖自動選擇文生圖或圖片編輯介面。
從 gpt-image-2 切到 2.5 時不要原樣照搬 quality。 按 API易 2026-09-09 同尺寸實測的輸出 token 量,2.5 的 high 對應舊版 medium,2.5 的 max 才對應舊版 high——這是 token 預算的對應關係,不是逐畫素畫質相同的保證。想要與舊 high 同等預算的畫質,2.5 要選 max;同預算下 2.5 的 high / xhigh 則多了兩個更便宜的中間檔。
幾條節點層面的行為,寫工作流前先知道:
  • 不會靜默降檔:舊模型 gpt-image-2 選了 xhigh / max,或傳入無效模型 / 畫質,節點會在傳送請求前直接報錯,不會替你換檔跑
  • auto 建議少用:auto 是動態推理檔,同一條提示詞的費用與耗時會在檔位間漂移;要控成本就顯式選檔
  • 生產鎖日期快照:下拉里的 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 的四條約束:單邊不超過 3840px、寬高都是 16 的倍數、長邊 / 短邊不超過 3:1、總畫素在 655,360 到 8,294,400 之間。1:4 / 4:1 / 1:8 / 8:1 這幾個比例超出官方 3:1 限制,節點會自動收斂到最接近的合法邊界尺寸;4K + 1:1 用的是 2880x2880 而非 3840x3840,因為後者超總畫素上限。
節點不傳送 background / moderation / response_format / input_fidelity 這幾個欄位,全部走 API 預設值。需要透明背景等能力時請直接呼叫 API(透明背景要用 gpt-image-2.5-flare / gpt-image-2.5-sunburst,gpt-image-2 已於 2026-09-30 被官方關停),見 透明背景 FAQ。

Comfyui-Luck gpt-2.0 all(官逆)

gpt-image-2-all 不接受 size / quality / n / aspect_ratio 這些 API 欄位,節點不會發送它們;2K / 4K 只能作為 prompt 描述,無法保證輸出畫素。url 輸出通常是臨時 CDN 連結,約 1 天有效,需要長期儲存請儘快轉存。

Comfyui-Luck gpt-image-2-vip(官逆)

控制元件與 gpt-2.0 all 基本一致,多兩個尺寸控制元件:
作者按 API易 2026-06-23 的「size 失效」公告實現了這個節點,所以預設不傳送 size。API易 側 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, 字首,節點會自動相容解碼。

提示詞控制節點

  • 兩個控制器走 API易 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
  • 圖生圖提示詞控制器 只做影像理解與提示詞增強;要真正多圖參考 / 融合,同一批圖還要接到後面的出圖節點
  • 文本停留編輯器 的 edited_text 是單條字串,接普通出圖節點的 prompt;edited_texts 是列表輸出,留給批次文本工作流。暫停後點節點上的 Continue,不要再點主執行按鈕,否則 ComfyUI 會重新排隊並重跑上游的提示詞增強

安裝配置

1

第一步:克隆到 custom_nodes

進入 ComfyUI 安裝目錄:
已安裝過的使用者在該目錄 git pull 即可拿到 2.5 支援。
2

第二步:安裝依賴

3

第三步:完全重啟 ComfyUI

在節點搜尋欄輸入 Comfyui-Luck 即可看到三個出圖節點與三個提示詞節點。只重新整理前端不夠,更新外掛後必須重啟程序。
4

第四步:配置 API易 金鑰與域名

  • 訪問 API易控制台 →【令牌】新建金鑰(建議配用量上限)
  • 貼上到節點的 api_key 引數
  • api_base 二選一:https://api.apiyi.com/v1(主域名)/ https://b.apiyi.com/v1(國內備用)。節點底層相容帶或不帶 /v1 的寫法
5

第五步:匯入示例工作流

倉庫內有兩份示例:
  • example_workflow.json:三個出圖節點各一個示例(官轉示例用 size=2048x1152 + quality=high + jpeg),附中文 Note 說明怎麼選
  • example_workflow_gpt_image_2_5.json:獨立的 2.5 示例,Flare 文生圖 → Sunburst 編輯 → 預覽,預設 1K + 1:1、quality=high、超時 600 秒、retry_times=1
示例裡的 API Key 為空,填上即可執行;分享自己的工作流前記得清空 Key。

使用示例

示例 1:2.5 Flare 4K 高畫質文生圖

max 是 2.5 裡與舊版 gpt-image-2 high 同等 token 預算的檔位;想更快更省可先用 high 或 xhigh 試。

示例 2:2.5 Sunburst mask 局部重繪

示例 3:Flare 文生圖 → Sunburst 編輯串聯

對應倉庫裡的 example_workflow_gpt_image_2_5.json:

示例 4:官逆對話式出圖

示例 5:提示詞控制器 → 暫停手改 → 出圖

對最終的 PreviewImage / SaveImage 發起佇列執行,流程停在 文本停留編輯器 時改好文本,點節點上的 Continue 繼續。若其中一張是必須鎖定的主體圖,額外接到控制器的 subject_image,並放到出圖節點的 image_01。

常見問題

  • Comfyui-Luck gpt-image-2(官轉):真實 size / quality、原生 mask、最多 16 張參考圖、按 token 計費——有明確尺寸要求、要局部重繪或要 2.5 六檔畫質的工作流選它;文生圖預設 gpt-image-2.5-flare,改圖選 gpt-image-2.5-sunburst
  • Comfyui-Luck gpt-2.0 all(官逆):按次計費($0.025 / 張)、約 30–60 秒、ChatGPT 網頁線——多輪改圖、文字還原要求高、不需要硬控尺寸的場景
  • Comfyui-Luck gpt-image-2-vip(官逆):按次計費($0.03 / 張)、約 90–150 秒、Adobe 線路——作為官逆的第二條線路備用;外掛當前不發 size
  • 完整差異看 官轉 vs 官逆 對比文件
不會。節點名稱、ID、控制元件順序和預設模型 gpt-image-2 都保持不變,舊工作流載入後仍跑 gpt-image-2 與原來的畫質。要用 2.5 請在 model (模型) 下拉里手動切換,並按上方對照表重新選 quality。
2.5 重新劃分了畫質檔位:按 API易 2026-09-09 同尺寸實測,2.5 的 high 輸出 token 只有 gpt-image-2 high 的約四分之一,對應舊版 medium;要拿到與舊 high 同等預算的畫質,2.5 要選 max。反過來,同預算下 2.5 多了 high / xhigh 兩個更便宜的中間檔。上生產前用自己的提示詞各跑一輪,比對 usage.output_tokens 再定檔。
官逆兩個節點的模型下拉當前只有 gpt-image-2-all 與 gpt-image-2-vip。其中 gpt-image-2-all 的來源 ChatGPT 網頁版已整體升級到 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。
  1. 確認目錄 ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0 存在
  2. pip install -r requirements.txt 無報錯
  3. 完全重啟 ComfyUI(只重新整理前端不夠)
  • 官轉節點預設 600 秒讀取超時,2.5 的 xhigh / max 與 2K / 4K 建議保留或調高;408 Timeout 通常是原廠生成任務超時,不是節點引數填錯
  • 同步請求在客戶端超時後仍可能計費,自動重試可能產生額外費用;不想自動重試把 retry_times 設為 1
  • 伺服器網路慢可參考 下載 CDN 圖片/影片很慢怎麼辦
  • 預設域名不穩時切換 api_base 到 b.apiyi.com/v1
舊工作流的 widget 順序與當前節點不匹配,retry_times=3 被錯讀成了 timeout_seconds=3。使用當前倉庫的 example_workflow.json,或刪掉節點重新新增即可。
把 prompt 轉成輸入口後,舊工作流少了一個 prompt 佔位,後面的控制元件整體前移(例如 mode 被讀成 gpt-image-2、api_base 被讀成 2K)。當前版本節點會在校驗階段放行並在執行時自動恢復錯位引數;若介面上仍顯示錯位,過載當前工作流或重新新增 Comfyui-Luck gpt-image-2 節點即可。
官逆 gpt-image-2-all / gpt-image-2-vip 的 b64_json 欄位會帶 data:image/png;base64, 字首,官轉 gpt-image-2 系列不帶。三個節點都會自動相容解碼,直接接 PreviewImage 即可。詳細說明見 官轉 vs 官逆 對比文件。
  1. 檢查 api_key 是否正確,是否被分組限制誤攔
  2. 所選模型是否在令牌的白名單內
  3. 餘額問題參考 為什麼還有餘額跑不通

相關資源

gpt-image-2.5 / 2(官轉)文件

flare / sunburst / gpt-image-2 三款同價同參數,原生 2K/4K,按 token 計費

GPT-image-2.5 上線解讀

Flare 更快、Sunburst 更準,六檔畫質與遷移建議

gpt-image-2-all(官逆)文件

ChatGPT 網頁線,$0.025 / 張按次計費

gpt-image-2-vip(官逆)文件

Adobe 線路,$0.03 / 張,支援 30 檔 size

官轉 vs 官逆 對比

一表看清官轉與官逆的差異

ComfyUI 節點合集

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

Luck Nano Banana Pro(同作者)

luckdvr 的 Gemini 系列 ComfyUI 節點

APIYI GPT-Image 2 Skills(同模型)

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

API易控制台

管理金鑰、用量與分組