|

3步接入 Nano Banana 2 到 ComfyUI – Gemini 圖片生成模型切換完整教程

在 ComfyUI 中使用 Gemini 圖片生成模型是很多創作者的需求。本文將介紹 如何 3 步將 Nano Banana 2 接入 ComfyUI,實現文生圖、圖生圖等工作流,並且支持在 NB2、NB Pro、NB 全系列模型之間一鍵切換。

核心價值: 讀完本文,你將學會在 ComfyUI 中配置 Gemini 圖片生成 API,掌握模型切換技巧,快速搭建 AI 圖片生成工作流。

nano-banana-2-comfyui-gemini-image-generation-tutorial-zh-hant 图示


Nano Banana 2 ComfyUI 接入核心要點

Nano Banana 2 (gemini-3.1-flash-image-preview) 是 Google 最新發布的圖片生成模型,通過 ComfyUI 自定義節點可以輕鬆接入。

要點 說明 價值
插件安裝 支持多種 ComfyUI 自定義節點 靈活選擇適合的方案
API 配置 設置 base_url 和 API Key 即可 5 分鐘完成配置
模型切換 只需修改 model 參數 一鍵切換全系列模型
工作流 文生圖、圖生圖、風格遷移 覆蓋主流創作場景

Nano Banana 2 ComfyUI 接入重點詳解

接入 Nano Banana 2 到 ComfyUI 的核心在於: 選對插件 + 配對 API。與直接調用 Google 官方 API 不同,通過 API易 apiyi.com 的統一接口,你可以在 ComfyUI 中無縫使用全系列 Gemini 圖片生成模型,無需處理網絡和認證的複雜問題。

接入方案本質上和 Nano Banana Pro 完全一樣,唯一的區別就是模型名稱不同。如果你之前已經配置過 NB Pro,只需要把模型名換成 gemini-3.1-flash-image-preview 即可。

爲什麼選擇通過 ComfyUI 接入 Nano Banana 2

相比直接使用 API 調用或其他工具,ComfyUI 接入有以下獨特優勢:

  • 可視化工作流: 節點式操作,所見即所得,調試方便
  • 批量處理能力: 支持隊列批量生成,適合大量圖片需求
  • 工作流複用: 搭建一次工作流,反覆使用,提升效率
  • 擴展性強: 可以和其他 ComfyUI 節點組合,實現後處理、超分辨率等
  • 本地運行: 工作流在本地執行,只有 API 調用走網絡,數據更安全

Nano Banana 2 全系列模型對比

在接入 ComfyUI 之前,先了解 API易 提供的全系列 Gemini 圖片生成模型:

對比維度 Nano Banana 2 Nano Banana Pro Nano Banana
模型名稱 gemini-3.1-flash-image-preview gemini-3-pro-image-preview gemini-2.5-flash-image
畫質等級 Pro級畫質 最高畫質 優秀畫質
生成速度 最快 較慢 快速
最大分辨率 4K 4K 2K
寬高比 14種 10種 10種
獨家功能 圖像搜索 Grounding
API易價格 $0.03/次 $0.05/次 $0.025/次
狀態 Preview Preview GA

nano-banana-2-comfyui-gemini-image-generation-tutorial-zh-hant 图示

Nano Banana 2 支持的寬高比

Nano Banana 2 支持 14 種寬高比,是三個模型中最多的,在 ComfyUI 節點的 aspect_ratio 參數中選擇:

寬高比 適用場景 寬高比 適用場景
1:1 頭像、社交媒體 9:16 手機壁紙、短視頻封面
16:9 橫版封面、桌面壁紙 3:4 豎版海報
4:3 傳統照片比例 2:3 人像攝影
3:2 風景照片 9:21 超長豎版
21:9 超寬屏 4:5 Instagram
5:4 方形偏橫 16:10 顯示器比例
10:16 豎版橫幅 自定義 按需設置

🎯 選擇建議: Nano Banana 2 在畫質和速度之間取得了最佳平衡,推薦作爲 ComfyUI 日常創作的首選模型。通過 API易 apiyi.com 可以獲取全系列模型的統一 API 接口,方便隨時切換。


Nano Banana 2 ComfyUI 插件方案選擇

目前支持 Gemini 圖片生成的 ComfyUI 插件有多個選擇,我們推薦以下兩種方案:

方案 A: ComfyUI-IF_Gemini 插件 (推薦)

ComfyUI-IF_Gemini 是目前最成熟的 Gemini ComfyUI 節點,原生支持 base_url 配置,非常適合通過 API易 接入。

優勢:

  • 原生支持自定義 base_url,可直接填寫 API易 接口地址
  • 支持文生圖、圖生圖、多輪對話等多種工作流
  • 活躍維護,社區反饋響應快,功能持續更新
  • 使用環境變量配置 API Key,避免硬編碼,安全便捷
  • 支持設置 temperature、aspect_ratio 等高級參數

GitHub 倉庫: github.com/if-ai/ComfyUI-IF_Gemini

適合人羣: 需要深度使用 Gemini 圖片生成功能的用戶,希望自定義更多參數,搭建複雜工作流的創作者。

方案 B: comfyui-gemini-nodes (OpenAI 兼容模式)

comfyui-gemini-nodes 由 jqy-yo 開發,支持通過 OpenAI 兼容模式接入,適合已有 OpenAI 接口經驗的用戶。

優勢:

  • OpenAI 兼容接口,已有 OpenAI 使用經驗的用戶零學習成本
  • 支持 base_url + api_key + model 三個參數自定義
  • 輕量級實現,安裝依賴少,不容易產生環境衝突
  • 直接在節點界面填寫參數,所見即所得

GitHub 倉庫: github.com/jqy-yo/comfyui-gemini-nodes

適合人羣: ComfyUI 新手,希望快速上手驗證效果的用戶,以及已有 OpenAI 接口使用經驗的開發者。

Nano Banana 2 ComfyUI 插件方案對比

對比維度 ComfyUI-IF_Gemini comfyui-gemini-nodes
接入方式 原生 Gemini API OpenAI 兼容模式
base_url 支持 ✅ 環境變量配置 ✅ 節點參數配置
安裝難度 中等 簡單
功能豐富度 高 (多輪對話等) 中等
維護活躍度 活躍 活躍
推薦場景 深度使用 快速上手

💡 技術建議: 如果你是 ComfyUI 新手,建議先用方案 B 快速上手;如果需要更豐富的功能,推薦方案 A。兩種方案都可以通過 API易 apiyi.com 的統一接口接入全系列 Gemini 模型。


Nano Banana 2 ComfyUI 快速上手

方案 A 安裝配置: ComfyUI-IF_Gemini

第 1 步: 安裝插件

# 進入 ComfyUI 自定義節點目錄
cd ComfyUI/custom_nodes

# 克隆插件倉庫
git clone https://github.com/if-ai/ComfyUI-IF_Gemini.git

# 安裝依賴
cd ComfyUI-IF_Gemini
pip install -r requirements.txt

第 2 步: 配置 API (關鍵步驟)

在 ComfyUI 根目錄創建或編輯 .env 文件:

# API易 統一接口配置
GEMINI_BASE_URL=https://vip.apiyi.com/v1
GEMINI_API_KEY=your_apiyi_api_key_here

🚀 快速開始: 通過 API易 apiyi.com 註冊即可獲取 API Key,支持全系列 Gemini 圖片生成模型的統一調用。

第 3 步: 選擇模型生成圖片

重啓 ComfyUI 後,在節點面板中找到 IF_Gemini 節點,設置模型參數:

model: gemini-3.1-flash-image-preview

切換其他模型只需修改這一個參數:

# Nano Banana 2 - Pro級畫質,最快速度
model: gemini-3.1-flash-image-preview

# Nano Banana Pro - 最高畫質
model: gemini-3-pro-image-preview

# Nano Banana - 性價比之選
model: gemini-2.5-flash-image

方案 B 安裝配置: comfyui-gemini-nodes

第 1 步: 安裝插件

cd ComfyUI/custom_nodes
git clone https://github.com/jqy-yo/comfyui-gemini-nodes.git
cd comfyui-gemini-nodes
pip install -r requirements.txt

第 2 步: 在節點中配置 API

重啓 ComfyUI,添加 Gemini 節點後,在節點屬性中配置:

base_url: https://vip.apiyi.com/v1
api_key: your_apiyi_api_key_here
model: gemini-3.1-flash-image-preview

第 3 步: 運行工作流

連接 Prompt 文本輸入節點,點擊 Queue Prompt 即可生成圖片。

nano-banana-2-comfyui-gemini-image-generation-tutorial-zh-hant 图示


Nano Banana 2 ComfyUI 完整代碼示例

極簡 Python 調用示例

如果你希望在 ComfyUI 之外先驗證 API 連通性,可以用以下代碼測試:

import openai

client = openai.OpenAI(
    api_key="your_apiyi_api_key",
    base_url="https://vip.apiyi.com/v1"  # API易 統一接口
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {
            "role": "user",
            "content": "Generate a beautiful sunset landscape painting"
        }
    ]
)

print(response.choices[0].message.content)
查看完整工作流配置 JSON

以下是 ComfyUI-IF_Gemini 的基本工作流配置參考:

{
  "nodes": [
    {
      "type": "IF_GeminiGenerateImage",
      "properties": {
        "model": "gemini-3.1-flash-image-preview",
        "prompt": "A beautiful sunset over mountains, oil painting style",
        "aspect_ratio": "16:9",
        "temperature": 0.8
      }
    }
  ],
  "env": {
    "GEMINI_BASE_URL": "https://vip.apiyi.com/v1",
    "GEMINI_API_KEY": "your_apiyi_api_key"
  }
}

說明: 實際節點屬性可能因插件版本不同略有差異,請參考插件文檔確認最新參數。

建議: 通過 API易 apiyi.com 獲取免費測試額度,先驗證 API 連通性再搭建複雜工作流。


Nano Banana 2 ComfyUI 工作流類型

文生圖工作流 (Text-to-Image)

最基礎也是最常用的工作流,輸入文字描述生成圖片:

[文本 Prompt] → [Gemini 節點] → [圖片預覽/保存]

參數建議:

  • model: gemini-3.1-flash-image-preview
  • 寬高比: 根據需求選擇 14 種之一 (1:1, 16:9, 9:16, 4:3, 3:4 等)
  • temperature: 0.7-0.9 (越高越有創意,越低越穩定)

Prompt 編寫技巧:

  • 使用英文 Prompt 通常效果更好
  • 描述順序建議: 主體 → 環境 → 風格 → 光線 → 細節
  • 示例: "A cute cat sitting on a windowsill, soft morning light, watercolor style, detailed fur texture"

圖生圖編輯工作流 (Image-to-Image)

上傳一張圖片,通過文字指令對圖片進行編輯修改:

[加載圖片] + [編輯 Prompt] → [Gemini 節點] → [編輯後圖片]

典型編輯指令:

  • "將背景改爲夜晚星空"
  • "給人物添加一頂帽子"
  • "把照片轉換爲水彩畫風格"
  • "移除圖片中的文字水印"
  • "將白天場景改爲黃昏"

使用要點: Nano Banana 2 的圖生圖能力非常強,能理解圖片內容並精確執行編輯指令。建議編輯指令儘量具體,避免模糊描述。

風格遷移工作流 (Style Transfer)

將一張圖片的風格應用到另一張圖片,實現創意組合:

[風格參考圖] + [內容圖] + [Prompt] → [Gemini 節點] → [風格化圖片]

常見風格遷移場景:

  • 將照片轉換爲油畫、水彩、素描等藝術風格
  • 將產品圖轉換爲特定品牌視覺風格
  • 將普通照片轉換爲動漫或插畫風格

多輪對話工作流 (Multi-turn)

Nano Banana 2 支持多輪對話式圖片生成和編輯,這是傳統 Stable Diffusion 模型不具備的獨特能力:

第1輪: [Prompt: 畫一隻貓] → [生成貓圖片]
第2輪: [上一輪圖片 + Prompt: 給貓戴上紅色圍巾] → [編輯後圖片]
第3輪: [上一輪圖片 + Prompt: 把背景換成雪景] → [最終圖片]

優勢: 通過多輪迭代逐步完善圖片,比一次性複雜 Prompt 效果更可控。

Nano Banana 2 ComfyUI 工作流推薦配置

工作流類型 推薦模型 推薦寬高比 預估耗時
文生圖 (日常) NB2 1:1 / 16:9 3-5秒
文生圖 (高質量) NB Pro 1:1 / 4:3 8-15秒
圖生圖編輯 NB2 與原圖一致 3-6秒
風格遷移 NB2 與原圖一致 4-7秒
批量生成 NB 1:1 2-4秒

💰 成本優化: 日常創作推薦使用 Nano Banana 2,通過 API易 apiyi.com 調用僅需 $0.03/次,兼顧畫質與成本。批量生成場景可以切換到 Nano Banana ($0.025/次) 進一步降低成本。


Nano Banana 2 ComfyUI 模型切換技巧

一鍵切換的核心方法

全系列模型通過 API易 apiyi.com 統一接口調用,切換模型只需修改一個參數:

# 方法: 只改 model 參數,其他不變

# Nano Banana 2 - 日常首選
model = "gemini-3.1-flash-image-preview"

# Nano Banana Pro - 追求極致畫質
model = "gemini-3-pro-image-preview"

# Nano Banana - 追求性價比
model = "gemini-2.5-flash-image"

在 ComfyUI 節點中,只需在 model 下拉框或文本框中切換對應的模型名稱即可。base_url 和 API Key 完全不需要改動

模型切換決策流程

根據你的創作需求選擇模型:

需要最高畫質? → NB Pro (gemini-3-pro-image-preview)
     ↓ 否
需要 4K + 高速? → NB2 (gemini-3.1-flash-image-preview)
     ↓ 否
追求最低成本? → NB (gemini-2.5-flash-image)

nano-banana-2-comfyui-gemini-image-generation-tutorial-zh-hant 图示


其他 Nano Banana 2 ComfyUI 插件

除了推薦的兩個方案,社區還有其他相關插件可供參考:

插件名稱 特點 base_url 支持 適用場景
ComfyUI-NanoBanano 專爲 Nano Banana 系列設計 ⚠️ 部分 快速體驗
comfy_nanobanana 輕量級實現 ⚠️ 部分 簡單工作流
ComfyUI_Nano_Banana 社區維護版本 ⚠️ 部分 特定功能需求
ComfyUI Partner Node (官方) Google 官方合作節點 ❌ 不支持 僅支持官方 API

注意: ComfyUI 官方的 Partner Node 不支持第三方 API 接入,如果需要通過 API易 使用,請選擇方案 A 或方案 B。其他社區插件的 base_url 支持情況因版本而異,使用前請查看對應 GitHub 倉庫的文檔說明。

Nano Banana 2 ComfyUI 插件安裝注意事項

在安裝 ComfyUI 自定義節點時,請注意以下常見問題:

  1. Python 環境: 確保使用 ComfyUI 自帶的 Python 環境安裝依賴,避免系統 Python 和 ComfyUI Python 混淆
  2. 依賴衝突: 如果安裝多個 Gemini 相關插件,可能出現依賴版本衝突,建議只保留一個
  3. 插件更新: 定期通過 git pull 更新插件代碼,獲取最新功能和修復
  4. 日誌排查: 遇到問題時查看 ComfyUI 控制檯輸出,通常會有明確的錯誤信息
# 更新插件到最新版本
cd ComfyUI/custom_nodes/ComfyUI-IF_Gemini
git pull
pip install -r requirements.txt

常見問題

Q1: ComfyUI 中配置 Nano Banana 2 後提示 API Key 無效怎麼辦?

請檢查以下幾點:

  1. 確認 API Key 正確: 登錄 API易 apiyi.com 後臺複製完整的 API Key
  2. 檢查 base_url: 確保設置爲 https://vip.apiyi.com/v1,注意末尾有 /v1
  3. 環境變量生效: 如果使用 .env 文件,需要重啓 ComfyUI 才能加載
  4. Key 權限: 確認你的 API Key 已開通圖片生成模型的調用權限

通過 API易 apiyi.com 獲取的 Key 默認支持全系列 Gemini 模型,如遇問題可聯繫客服排查。

Q2: Nano Banana 2 在 ComfyUI 中生成圖片很慢或超時怎麼辦?

生成速度受多個因素影響:

  1. 網絡環境: 使用 API易 apiyi.com 的 base_url 可以優化網絡路徑,通常比直連官方 API 更穩定
  2. 分辨率選擇: 4K 分辨率比 2K 需要更多時間,日常測試建議先用低分辨率
  3. 模型選擇: NB2 速度最快 (3-5秒),NB Pro 較慢 (8-15秒)
  4. 超時設置: 在插件配置中將超時時間設爲 60 秒以上
Q3: 如何在 ComfyUI 中實現多模型自動切換?

可以使用 ComfyUI 的條件節點來實現自動切換:

  1. 創建一個「模型選擇器」文本節點,輸入模型名稱
  2. 將該節點連接到 Gemini 節點的 model 輸入
  3. 通過下拉選擇或文本輸入切換: gemini-3.1-flash-image-previewgemini-3-pro-image-previewgemini-2.5-flash-image

所有模型共用同一個 API易 base_url 和 API Key,切換模型不需要重新配置。

Q4: Google 官方免費層是否支持 Nano Banana 2 圖片生成?

不支持。Google AI Studio 的免費層 (Free Tier) 不支持圖片生成功能,調用時會返回錯誤。要使用 Gemini 圖片生成功能,需要:

  1. 使用 Google Cloud 付費 API (需要信用卡和海外賬號)
  2. 或通過 API易 apiyi.com 平臺調用,無需海外信用卡,按次計費更靈活
Q5: Nano Banana 2 的安全過濾導致圖片生成失敗怎麼處理?

Gemini 3.1 Flash Image 有內置的安全過濾機制,以下提示詞可能觸發過濾:

  1. 人物相關: 涉及真實人物、名人的描述
  2. 敏感內容: 暴力、血腥等描述
  3. 版權相關: 知名 IP 角色的精確描述

解決方法: 調整提示詞,使用更抽象和通用的描述方式。如果頻繁遇到安全過濾,建議參考我們的 Nano Banana 2 內容安全機制詳解文章。


Nano Banana 2 ComfyUI 接入總結

Nano Banana 2 接入 ComfyUI 的核心步驟非常簡單: 安裝插件 → 配置 API → 選擇模型

關鍵要點回顧

步驟 操作 耗時
安裝插件 git clone + pip install 2 分鐘
配置 API 設置 base_url + API Key 1 分鐘
選擇模型 填寫模型名稱 30 秒
測試運行 Queue Prompt 生成圖片 1 分鐘

核心結論

  1. 選擇合適的插件: 推薦 ComfyUI-IF_Gemini (功能豐富) 或 comfyui-gemini-nodes (快速上手)
  2. 配置 API易 統一接口: 設置 base_url 爲 https://vip.apiyi.com/v1,一次配置即可使用全系列模型
  3. 靈活切換模型: NB2 ($0.03)、NB Pro ($0.05)、NB ($0.025),只需修改 model 參數
  4. 多種工作流: 文生圖、圖生圖、風格遷移、多輪對話,滿足不同創作需求
  5. 獨家功能: NB2 獨有的圖像搜索 Grounding 功能,爲創作帶來更多可能性

推薦通過 API易 apiyi.com 快速獲取 API Key,5 分鐘即可在 ComfyUI 中體驗 Nano Banana 2 的 Pro 級畫質和極速生成。全系列模型統一接口,隨時按需切換。


作者: APIYI Team | 技術交流: API易 apiyi.com

本文基於 ComfyUI 最新版本和 API易 平臺實測,如有插件更新請參考對應 GitHub 倉庫文檔。

Similar Posts