README
心宝❤Banana - ComfyUI Gemini Image Generator
为 ComfyUI 提供 Nano Banana 图像生成能力的自定义节点
| Windows | Linux | macOS |
|---|---|---|
| comfyui-banana-li | comfyui-banana-li-linux | comfyui-banana-li-mac |
📖 简介
Banana 是一个强大的 ComfyUI 自定义节点,集成了 Google NanoBanana 的图像生成 API。支持文本到图像、图像到图像等多种生成模式,让你在 ComfyUI 工作流中轻松使用最新的 AI 图像生成技术。
大家好，我是李心宝，一个在电商设计领域摸爬滚打了多年的老设计。我专注在如何让 AI 技术真正在咱们的日常工作中落地，提升效率。我乐于分享自己深度评测、实践过、确实好用的 AI 工作流和设计技巧，希望能和大家一起探索、共同进步。我整理、制作了不少免费的工作流和资料，希望能帮你少走弯路。
当然，如果你需要更精细化、针对性更强的解决方案，我也提供付费的专属工作流。期待能和更多志同道合的设计人、电商人、AI实践者们交个朋友，一起把 AI 设计玩明白！
免费资料与专属工作流介绍
📂 点击访问飞书文档 - 获取免费资料及专属工作流详情
📺 视频教程
访问我的 B站主页 观看详细的使用教程和案例演示!
部分视频
📮 联系方式
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 应用快速切换。 - 变更：移除「心宝路径加载」相关节点/功能（若你在开发版工作流中用过该节点，需要改线）。
- 安全：清理仓库中误提交的运行时文件/敏感数据，补充忽略规则，降低泄露风险。
🚀 安装
- 将仓库克隆到 ComfyUI 的
custom_nodes目录：
cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li.git comfyui-banana-li
cd comfyui-banana-li
- 本插件自带原
segment_nodes_li全量节点与模型脚本，无需额外安装。 - 依赖需在 ComfyUI 环境中提前安装（常见：torch、opencv-contrib-python、transformers[AutoProcessor]、scipy、Pillow、requests）。
⚙️ 配置
-
仓库已附带
config.ini模板，直接编辑其中的[gemini]段落填入 API Key（请使用官方渠道获取；若文件被清理，可重新从仓库获取同名模板）。 -
并发与性能（按机器/网络调整）：
max_workers：本地解码/处理并发，建议 2-8。network_workers_cap：网络并发上限（1-8），网络不稳时建议 2-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 输出并在文本端口显示错误）。
📝 快速上手
文生图（最小可用）
- 启动 ComfyUI，搜索并添加
心宝❤Banana节点。 - 在节点参数填入 API Key，设置
batch_size=1-4，选择合适aspect_ratio。 - 输入提示词，运行后将输出图像张量，可接预览或保存节点。
图生图
加载图像 → 心宝❤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（支持关键字检索）。
🤝 支持与反馈
- 问题与建议：请提交 GitHub Issues。
- 更新动态与教程：关注 B 站
@李心宝爱玩Ai（可私信沟通）。
⭐ 觉得有用请点个 Star！
Contributors
43 commits
29 commits
Similar repos
Languages
JavaScript
51.2%
Python
46.6%
HTML
2.2%
README
心宝❤Banana - ComfyUI Gemini Image Generator
为 ComfyUI 提供 Nano Banana 图像生成能力的自定义节点
| Windows | Linux | macOS |
|---|---|---|
| comfyui-banana-li | comfyui-banana-li-linux | comfyui-banana-li-mac |
📖 简介
Banana 是一个强大的 ComfyUI 自定义节点,集成了 Google NanoBanana 的图像生成 API。支持文本到图像、图像到图像等多种生成模式,让你在 ComfyUI 工作流中轻松使用最新的 AI 图像生成技术。
大家好，我是李心宝，一个在电商设计领域摸爬滚打了多年的老设计。我专注在如何让 AI 技术真正在咱们的日常工作中落地，提升效率。我乐于分享自己深度评测、实践过、确实好用的 AI 工作流和设计技巧，希望能和大家一起探索、共同进步。我整理、制作了不少免费的工作流和资料，希望能帮你少走弯路。
当然，如果你需要更精细化、针对性更强的解决方案，我也提供付费的专属工作流。期待能和更多志同道合的设计人、电商人、AI实践者们交个朋友，一起把 AI 设计玩明白！
免费资料与专属工作流介绍
📂 点击访问飞书文档 - 获取免费资料及专属工作流详情
📺 视频教程
访问我的 B站主页 观看详细的使用教程和案例演示!
部分视频
📮 联系方式
✨ 功能特性
- 🎨 多模态输入：文本、文本+多张参考图
- 🔢 批量生成：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 应用快速切换。 - 变更：移除「心宝路径加载」相关节点/功能（若你在开发版工作流中用过该节点，需要改线）。
- 安全：清理仓库中误提交的运行时文件/敏感数据，补充忽略规则，降低泄露风险。
🚀 安装
- 将仓库克隆到 ComfyUI 的
custom_nodes目录：
cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li.git comfyui-banana-li
cd comfyui-banana-li
- 本插件自带原
segment_nodes_li全量节点与模型脚本，无需额外安装。 - 依赖需在 ComfyUI 环境中提前安装（常见：torch、opencv-contrib-python、transformers[AutoProcessor]、scipy、Pillow、requests）。
⚙️ 配置
-
仓库已附带
config.ini模板，直接编辑其中的[gemini]段落填入 API Key（请使用官方渠道获取；若文件被清理，可重新从仓库获取同名模板）。 -
并发与性能（按机器/网络调整）：
max_workers：本地解码/处理并发，建议 2-8。network_workers_cap：网络并发上限（1-8），网络不稳时建议 2-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 输出并在文本端口显示错误）。
📝 快速上手
文生图（最小可用）
- 启动 ComfyUI，搜索并添加
心宝❤Banana节点。 - 在节点参数填入 API Key，设置
batch_size=1-4，选择合适aspect_ratio。 - 输入提示词，运行后将输出图像张量，可接预览或保存节点。
图生图
加载图像 → 心宝❤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（支持关键字检索）。
🤝 支持与反馈
- 问题与建议：请提交 GitHub Issues。
- 更新动态与教程：关注 B 站
@李心宝爱玩Ai（可私信沟通）。
⭐ 觉得有用请点个 Star！
Similar repos
Contributors
43 commits
29 commits
Languages
JavaScript
51.2%
Python
46.6%
HTML
2.2%