概述
Comfyui-LuckNanoBananaPro 是社群使用者 luckdvr 貢獻的 ComfyUI 自定義節點，通過 API易 呼叫 Gemini 3 Pro Image Preview / Flash 進行文生圖與多圖編輯。相比基礎版節點，它的最大亮點是工程化：內建超時重試、即時進度指示、ComfyUI 原生 seed 管理，以及最多 14 張圖片堆疊輸入，適合對穩定性和批次控制有要求的生產工作流。
專案資訊
- 🔗 開源地址：
github.com/luckdvr/Comfyui-LuckNanoBananaPro - 📜 許可證：MIT / Apache-2.0 雙許可
- 👤 作者：luckdvr
- ⭐ 該專案由社群使用者貢獻，專為 API易 適配
核心功能
14 張圖同時輸入
image_01 ~ image_14 引數位可堆疊最多 14 張參考圖，覆蓋 Nano Banana Pro 的理論輸入上限多檔解析度
支援 1K / 2K / 4K 三檔輸出，搭配自適應超時，兼顧速度與畫質
15 種寬高比
預置豐富的寬高比選項，覆蓋豎屏、橫屏、方圖、電影寬幅等常見需求
雙模型切換
gemini-3-pro-image-preview（Pro）與 gemini-3.1-flash-image-preview（Flash）自由切換超時與重試
timeout_seconds（10-600s）+ retry_times（1-20 次）可配置，高峰期也穩即時進度指示
節點內建狀態、百分比、計時顯示，長任務不再黑盒
原生 Seed 管理
支援 ComfyUI 標準的 fixed / random / increment / decrement 四種 seed 模式
MIT / Apache-2.0 雙許可
寬鬆許可，商用與二次開發都無憂
支援的 API易 模型
節點引數
安裝配置
1
第一步：克隆到 custom_nodes
進入 ComfyUI 安裝目錄：
2
第二步：安裝依賴
3
第三步：重啟 ComfyUI
重啟後在節點搜尋欄輸入
Luck Nano Banana Pro 即可找到節點。4
第四步：配置 API易 金鑰
- 訪問 API易控制台 →【令牌】，新建一個帶用量上限的專用金鑰（安全最佳實踐）
- 貼上到節點
api_key引數即可 - 節點內部已指向
api.apiyi.com，無需額外配置
5
第五步：搭建工作流
- 文生圖：直接填
prompt，不連線任何參考圖 - 多圖編輯：將多個
Load Image連到image_01,image_02…，搭配prompt描述編輯指令
使用示例
示例 1：高穩定性文生圖
示例 2：多圖融合
示例 3：Seed 批次探索
通過 ComfyUI 原生 seed 管理，在increment 模式下批次跑多個種子，快速對比同一 prompt 的變化。
常見問題
節點找不到？
節點找不到？
- 確認倉庫在
ComfyUI/custom_nodes/Comfyui-LuckNanoBananaPro - 依賴安裝無報錯（尤其是 requests / Pillow / numpy）
- 完全重啟 ComfyUI（重新整理前端不夠）
4K 經常超時？
4K 經常超時？
該節點已支援可調
timeout_seconds：- 4K 場景建議
timeout_seconds=300起步 - 搭配
retry_times=5自動重試，應對網路抖動 - 若仍頻繁超時，參考 下載 CDN 圖片/影片很慢怎麼辦 最佳化伺服器網路
14 張參考圖都會被使用嗎？
14 張參考圖都會被使用嗎？
節點允許連線最多 14 張，但實際是否參與生成取決於 prompt 的描述。建議在 prompt 中明確引用
image_01 / image_02…，或用自然語言描述每張圖的作用，模型會按你的指令選擇性使用。呼叫返回 401 / 403？
呼叫返回 401 / 403？
api_key是否正確、未被分組限制誤攔- 所選模型是否在令牌的白名單內
- 餘額是否充足，參考 為什麼還有餘額跑不通
和其他兩款 Nano Banana ComfyUI 節點有什麼區別？
和其他兩款 Nano Banana ComfyUI 節點有什麼區別？
- nano-banana-comfyui（功能完整版）：強調對話式編輯與多輪記憶
- apiyi-nano-banana-node（輕量示例）：程式碼最簡，適合學習/拓展
- Luck Nano Banana Pro（本頁）：引數工程化（超時 / 重試 / 14 圖），適合批次與穩定生產
相關資源
Nano Banana Pro API 文件
模型完整能力與 API 引數說明
Luck GPT-Image 2（同作者）
luckdvr 的 OpenAI 系列 ComfyUI 節點：
gpt-image-2 + gpt-image-2-allComfyUI 節點合集
檢視更多 Nano Banana ComfyUI 節點
FAQ：CDN 下載慢
4K 圖片下載慢？看這裡
API易控制台
管理金鑰、用量與分組