# 心宝❤Banana - ComfyUI Gemini Image Generator Banana Logo

> 为 ComfyUI 提供 Nano Banana 图像生成能力的自定义节点 [![GitHub](https://img.shields.io/badge/GitHub-comfyui--banana--li-blue)](https://github.com/98624017/comfyui-banana-li) [![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://www.python.org/) [![ComfyUI](https://img.shields.io/badge/ComfyUI-Custom_Node-orange)](https://github.com/comfyanonymous/ComfyUI) [![Bilibili](https://img.shields.io/badge/Bilibili-@李心宝爱玩Ai-ff69b4)](https://space.bilibili.com/470042957)

## 📖 简介 Banana 是一个强大的 ComfyUI 自定义节点,集成了 Google NanoBanana 的图像生成 API。支持文本到图像、图像到图像等多种生成模式,让你在 ComfyUI 工作流中轻松使用最新的 AI 图像生成技术。大家好，我是李心宝，一个在电商设计领域摸爬滚打了多年的老设计。我专注在如何让 AI 技术真正在咱们的日常工作中落地，提升效率。我乐于分享自己深度评测、实践过、确实好用的 AI 工作流和设计技巧，希望能和大家一起探索、共同进步。我整理、制作了不少免费的工作流和资料，希望能帮你少走弯路。当然，如果你需要更精细化、针对性更强的解决方案，我也提供付费的专属工作流。期待能和更多志同道合的设计人、电商人、AI实践者们交个朋友，一起把 AI 设计玩明白！ ###

免费资料与专属工作流介绍 📂 [点击访问飞书文档](https://lcni4wauvbvx.feishu.cn/docx/BODPdxQ51ontbzxbq7tcUvlsnMd) - 获取免费资料及专属工作流详情 ## 📺 视频教程访问我的 [B站主页](https://space.bilibili.com/470042957) 观看详细的使用教程和案例演示! ### 部分视频 -

[香蕉100%不偏移技巧,效率提升N倍](https://www.bilibili.com/video/BV1ir1cBVEeA) -

[心宝顶级放大系列-03人像类放大](https://www.bilibili.com/video/BV1J7yXBoEq6) -

[心宝顶级放大05-100%修手修脚](https://www.bilibili.com/video/BV1LSnZzoERc) -

[4K透溶V2——纠正背景透视,一键换背景、融合、打光](https://www.bilibili.com/video/BV1mhaazPE13) ## 📮 联系方式 - **GitHub Issues**: [提交问题和建议](https://github.com/98624017/comfyui-banana-li/issues) - **Bilibili**: [@心宝](https://space.bilibili.com/470042957) - 视频教程和更新动态 - **获取公开资料及API 购买**:

Li_18727107073 ## ✨ 功能特性 - 🎨 多模态输入：文本、文本+多张参考图 - 🔢 批量生成：1-8 张，支持固定种子复现 - 📐 多种比例：Auto/1:1/9:16/16:9/21:9 等 - 🔄 智能重试：指数退避，失败返回可视化错误图 - ⚡ 并发控制：本地处理与网络并发可独立配置 - 💰 余额查询：Web UI 扩展实时展示可用/已用额度 - 🧩 增强节点：绑定上下文、裁剪贴图、分割一键集成 - 🆕 ModelScope：文生图与多模态图像描述两类节点 - 💡 **提示词助手**：内置可视化词库管理，支持点击上屏、智能移除、颜色分类与悬浮预览。 ## 🗒️ 更新日志 > 仅记录用户可明显感知且重要的变更；更完整的细节请查看提交记录。 ### 2026-01-26（27eeae4）→ 2026-02-27（e46aedb） - Gemini 生图：新增 `1:4 / 4:1 / 1:8 / 8:1` 等极端宽高比；非 `gemini-3.1-flash-image-preview` 模型会自动回退为 `Auto` 并提示。 - 视频节点：`心宝❤视频生成` 显示名更新为 `心宝❤视频生成Sora`（不影响已有工作流，仅方便搜索区分）。 - 新增节点：`心宝❤失败链接汇总`（`BananaFailedUrlAggregator`），可汇总多个 BananaV2 的 `failed_urls` 并可选自动重试下载。 - 新增节点：`心宝❤AI应用`（`XinbaoComfyApiApp`），支持基于 `comfy_api_apps.toml` 的多应用配置，并提供 Web UI 应用快速切换。 - 变更：移除「心宝路径加载」相关节点/功能（若你在开发版工作流中用过该节点，需要改线）。 - 安全：清理仓库中误提交的运行时文件/敏感数据，补充忽略规则，降低泄露风险。 ## 🚀 安装 1) 将仓库克隆到 ComfyUI 的 `custom_nodes` 目录： ```bash cd ComfyUI/custom_nodes git clone https://github.com/98624017/comfyui-banana-li.git comfyui-banana-li cd comfyui-banana-li ``` 2) 本插件自带原 `segment_nodes_li` 全量节点与模型脚本，无需额外安装。 3) 依赖需在 ComfyUI 环境中提前安装（常见：torch、opencv-contrib-python、transformers[AutoProcessor]、scipy、Pillow、requests）。 ## ⚙️ 配置 1) 仓库已附带 `config.ini` 模板，直接编辑其中的 `[gemini]` 段落填入 API Key（请使用官方渠道获取；若文件被清理，可重新从仓库获取同名模板）。 2) 并发与性能（按机器/网络调整）： - `max_workers`：本地解码/处理并发，建议 2-8。 - `network_workers_cap`：网络并发上限（1-8），网络不稳时建议 2-3。 3) 其他高级开关可在仓库内 `config.ini` 注释查看，通常保持默认即可直接使用。 > Base URL/线路选择现已在节点参数内完成，配置文件无需额外修改。 ## 🧩 节点一览 - **心宝❤Banana**：Gemini 生图主节点，支持文本/图像输入、批量、多比例、禁用 SSL（可选）。 - **心宝❤BananaV2**：新版 Gemini 生图节点（在 Banana 基础上扩展高级能力）。新增 `启用工作流并发` 开关（默认关闭）：开启后同一工作流中多个 BananaV2/视频节点可并发发起 API 调用；并发模式下单节点失败不会终止整图（会阻断该节点输出并在文本端口显示错误）。 - **心宝❤批量详情图保存**：批量详情图保存 + 拼接预览面板（提示词编辑/多选局部重试/同位置≤10版本对比/手动保存拼接图）。示例：`example_workflows/心宝一键详情页_批量详情图保存.json`。 - **心宝❤绑定生成** / **BananaLocalCropPreprocess/Paste** / **SegmentAnythingUltraLi**：绑定上下文与裁剪/分割增强节点，仅在需要绑定链路时接入。 - **余额扩展**：`web/extensions/token-balance.js` 自动加载，展示可用/已用额度与最近查询时间。 - **心宝❤魔搭文生图**：`Tongyi-MAI/Z-Image-Turbo`，batch 1-4，支持种子、负面提示词、尺寸/步数/guidance。 - **心宝❤多模态LLM反推**：多图输入（最多 3 张），可选香蕉/魔搭渠道，生成中文描述，支持温度与 max_tokens 设置。 - **心宝❤提示词助手**：全功能的提示词管理面板，支持自定义标签/颜色、增删改查片段、长文本悬浮预览以及智能的点击交互（点击添加/反选删除/Shift强制追加）。 - **心宝❤视频生成**：文本/参考图生成视频节点。新增 `启用工作流并发` 开关（默认关闭）：开启后可与其它并发节点同时发起请求；并发模式下单节点失败不会终止整图（会阻断该节点 VIDEO 输出并在文本端口显示错误）。 ## 📝 快速上手 ### 文生图（最小可用） 1. 启动 ComfyUI，搜索并添加 `心宝❤Banana` 节点。 2. 在节点参数填入 API Key，设置 `batch_size=1-4`，选择合适 `aspect_ratio`。 3. 输入提示词，运行后将输出图像张量，可接预览或保存节点。 ### 图生图 ``` 加载图像 → 心宝❤Banana（image_1 输入） ↗ 文本提示词 ``` 可额外提供最多 5 张参考图像，结合文本指导生成。 ### 绑定增强链路（可选） ``` 心宝❤绑定生成 → 裁切/分割等前置增强 → 心宝❤Banana → BananaLocalCropPaste ``` 仅在需要局部编辑/对齐裁剪时接入，普通生图可不连接 `binding_context`。 ### ModelScope 示例 - 文生图：选择 `心宝❤魔搭文生图` 节点，填入 ModelScope API Key，batch ≤4，按需设置尺寸/步数。 - 图像描述：使用 `心宝❤多模态LLM反推`，可输入最多 3 张图像并选择香蕉/魔搭渠道生成中文描述。 ## 💡 心宝❤提示词助手使用指南这是一个完全可视化的提示词管理面板，旨在替代枯燥的文本输入框。 ### 1. 核心交互 - **智能点击**: - 点击词条将其**添加**到末尾（自动处理逗号）。 - 若词条已存在，再次点击会自动**移除**（相当于撤销）。 - 🔴 **红色角标**：显示该词条在当前提示词中出现的次数。 - **Shift + 点击**: 强制追加内容（即使已存在）。 - **悬浮预览**: 鼠标停留在长词条上 0.6秒，展示完整内容的悬浮窗。 ### 2. 词库管理 - **添加片段**: 点击绿色“添加”按钮，支持自定义内容、分类（可直接输入新标签）和 10 种预设颜色。 - **编辑/删除**: - 点击右上角“编辑模式”，词条变为可点击编辑状态。 - 在弹窗中可修改内容/颜色，或点击左下角红色按钮**删除**。 - **分类筛选**: 顶部标签栏支持点击筛选，轻松管理海量词库。 - **本地存储**: 所有数据存储于插件目录下的 `snippets.toml`，方便备份与迁移。 ## 🎛️ 关键参数（Gemini 生图） | 参数 | 说明 | 建议 | |---|---|---| | api_key | 为空时读取 `config.ini` | 必填，勿泄露 | | batch_size | 1-8，批量输出 | 常用 1-4，避免高并发丢图风险 | | aspect_ratio | Auto/1:1/9:16/16:9/21:9 等 | 按场景选择 | | seed | -1 随机，0-102400 固定 | 复现结果时设定 | | image_size | 1K/2K/4K（gemini-3-pro-image*） | 默认 2K | | 禁用SSL验证 | 临时绕过证书校验 | 仅在可信网络下启用 | > 高并发/大批量（特别是 8 张）在少数场景可能出现“请求成功但不返图”且仍计费的上游行为。追求稳定建议 batch 控制在 1-4，并视网络情况调低 `network_workers_cap`。 ## 🔒 安全与费用提示 - API Key 仅存放本地 `config.ini` 或节点参数，勿上传到公开仓库/分享工作流。 - 关闭 SSL 校验或使用代理会增加泄露风险，请确保网络可信。 - 每次生成都会计费，调参前先用低 batch 小步验证。 ## 🐛 故障排除 - 节点未加载：检查依赖安装与 ComfyUI 日志，重启后重试。 - 请求失败：确认 API Key 正确、网络连通、余额充足；必要时降低 batch 与并发。 - 生成慢：降低 `batch_size`，调低并发，检查网络延迟。 - 常见报错速查：见文档 [Gemini_Imagen_Generator 节点常见报错 QA](./.doc/Gemini_Imagen_Generator_QA.md)（支持关键字检索）。 ## 🤝 支持与反馈 - 问题与建议：请提交 GitHub Issues。 - 更新动态与教程：关注 B 站 `@李心宝爱玩Ai`（可私信沟通）。

**⭐ 觉得有用请点个 Star！**

Name	Type	Description
IMAGE	IMAGE	—
MASK	MASK	—

心宝❤图片加载

Inputs (1)

Outputs (2)