Skip to main content

​
概述

ComfyUI-Nano-Banana-apiyi 是社群使用者貢獻的 ComfyUI 自定義節點集合，專為 API易 使用者打造。它讓你在 ComfyUI 工作流中直接呼叫谷歌最強影像生成模型 Nano Banana Pro 和 Nano Banana 2，無需配置谷歌雲賬號，只需 API易 金鑰即可開始創作。
專案資訊
  • 🔗 開源地址：github.com/pdmaker/ComfyUI-Nano-Banana-apiyi
  • 📜 許可證：MIT
  • 👤 作者：社群貢獻（原作者倉庫已刪除，現使用備份倉庫）
  • ⭐ 該專案由社群使用者貢獻，專為 API易 適配

​
為什麼選擇這個節點

零門檻接入

無需谷歌雲賬號，使用 API易 金鑰即可呼叫 Nano Banana Pro 和 Nano Banana 2 模型

多模態生圖

支援文生圖、圖生圖、多圖融合（最多 14 張參考圖），滿足各類創作需求

多輪對話編輯

獨創對話式影像生成，支援上下文記憶，逐步迭代最佳化圖片效果

超高解析度

支援 512px、1K、2K、4K 輸出，14 種寬高比，覆蓋海報、桌布、社交媒體等各種場景

​
支援的 API易 模型

模型怎麼選？ 追求極致畫質選 Nano Banana Pro；追求價效比和速度選 Nano Banana 2（低至 $0.025/張）。兩個模型都可以在同一個 ComfyUI 工作流中使用。

​
四大核心節點

本外掛提供 4 個功能節點，覆蓋不同的使用場景：

​
從零開始：安裝與配置

1

第一步：確認環境

請確保你的電腦已安裝以下軟體：
  • ComfyUI（最新版本）— 如未安裝，參考：github.com/comfyanonymous/ComfyUI
  • Python 3.12+
  • Git
Python 版本必須 3.12 或更高，低版本可能導致依賴安裝失敗。
2

第二步：下載節點程式碼

開啟終端，進入 ComfyUI 的自定義節點目錄，克隆倉庫：
3

第三步：安裝依賴

進入外掛目錄，安裝所需依賴：
如果要使用 Nano Banana 2 節點，還需額外安裝：
4

第四步：獲取 API易 金鑰

  1. 訪問 API易控制台 註冊/登入
  2. 進入【令牌】欄目
  3. 點選生成新的 API 金鑰
  4. 複製金鑰（以 sk- 開頭）備用
新使用者註冊即可獲得免費測試額度，足夠體驗 Nano Banana 影像生成功能。
5

第五步：配置環境變數

在外掛目錄中，複製模板檔案並填入金鑰：
編輯 .env 檔案，填入你的 API易 金鑰和 Base URL：
關鍵配置：CUSTOM_BASE_URL 必須設為 https://api.apiyi.com，這樣所有請求會通過 API易 轉發，無需谷歌雲賬號。程式碼會自動拼接正確的 API 版本路徑。
6

第六步：重啟 ComfyUI 並驗證

重啟 ComfyUI 後，在節點列表中搜索 Nano Banana，你應該能看到 4 個新節點：
  • Nano Banana AIO
  • Nano Banana Multi-Turn Chat
  • Nano Banana 2 AIO
  • Nano Banana 2 Multi-Turn Chat
如果能看到這些節點，說明安裝成功！

​
實戰教程：從文字到圖片

​
場景一：文字生成圖片（最基礎）

這是最簡單的用法——輸入一段文字描述，生成一張圖片。
1

新增節點

在 ComfyUI 畫布上右鍵，搜尋並新增 Nano Banana AIO 節點（或 Nano Banana 2 AIO）。
2

填寫提示詞

在 prompt 輸入框中填寫你想要的圖片描述，例如：
3

設定引數

  • image_count：生成圖片數量（1-10張）
  • aspect_ratio：選擇寬高比，如 16:9（橫屏桌布）或 9:16（手機桌布）
  • image_size：選擇解析度，推薦 2K 或 4K
  • temperature：創意程度，0.0 最保守，2.0 最天馬行空
4

執行工作流

點選 ComfyUI 的 Queue Prompt 按鈕，等待幾秒即可看到生成的圖片。

​
場景二：圖片編輯與融合

使用參考圖片來引導生成，適合風格遷移、元素融合等高階用法。
  1. 將 Nano Banana AIO 節點的 image_1 到 image_6 輸入端連線你的參考圖片
  2. 在 prompt 中描述你想要的效果，例如：“將這張照片轉換為水彩畫風格”
  3. 模型會結合參考圖片和文字描述生成新圖片
Nano Banana 2 AIO 獨家能力：支援最多 14 張參考圖（10 張物體 + 4 張角色一致性參考），適合需要保持角色外觀一致的連續創作場景。

​
場景三：多輪對話式編輯

這是 Nano Banana 節點最獨特的功能——像聊天一樣逐步最佳化圖片。
  1. 新增 Nano Banana Multi-Turn Chat 節點
  2. 第一輪：輸入初始描述，生成基礎圖片
  3. 第二輪：輸入修改指令，如”把背景換成海邊”
  4. 第三輪：繼續最佳化，如”增加夕陽光效”
  5. 每一輪都會基於之前的對話記憶進行修改
需要重新開始時，開啟 reset_chat 選項清除對話歷史。

​
節點引數詳解

​
Nano Banana AIO / Nano Banana 2 AIO

​
支援的寬高比

​
常見問題

請逐項檢查：
  1. 外掛資料夾是否在 ComfyUI/custom_nodes/ 目錄下
  2. 是否執行了 pip3 install -r requirements.txt
  3. 使用 Nano Banana 2 節點需額外執行 pip install google-genai --upgrade
  4. 是否重啟了 ComfyUI（不是重新整理網頁，是重啟後端服務）
請確認：
  1. .env 檔案中的 GOOGLE_API_KEY 填寫的是 API易 金鑰（以 sk- 開頭）
  2. CUSTOM_BASE_URL 設定為 https://api.apiyi.com
  3. API易 賬戶餘額充足（登入控制台檢視）
  • 4K 解析度生成時間較長，建議先用 1K 除錯效果
  • 多圖生成（image_count 大於 1）會增加耗時
  • 如果頻繁超時，可嘗試降低解析度或減少生成數量
  • Nano Banana Pro（gemini-3-pro-image-preview）：畫質更精細，適合高品質創作
  • Nano Banana 2（gemini-3.1-flash-image-preview）：速度更快、成本更低（$0.025/張起），支援更多參考圖和極端寬高比
  • 日常創作推薦 Nano Banana 2，追求極致品質選 Pro
訪問 API易控制台，註冊賬號後在【令牌】欄目生成新的金鑰。新使用者有免費測試額度。
Nano Banana 模型內建內容安全檢查，部分描述可能觸發限制。建議：
  1. 調整提示詞，避免敏感內容
  2. 檢視 Nano Banana 生圖失敗排查 獲取更多幫助

​
相關資源

Nano Banana Pro 文件

檢視 Nano Banana Pro 完整 API 文件和定價

Nano Banana 2 文件

檢視 Nano Banana 2 完整 API 文件和定價

生圖失敗排查

Nano Banana 生圖常見問題排查指南

API易-令牌管理

管理 API 金鑰、檢視用量和餘額