心宝❤Banana - ComfyUI Gemini Image Generator

Banana Logo

为 ComfyUI 提供 Nano Banana 图像生成能力的自定义节点

GitHub Python ComfyUI Bilibili

📖 简介

Banana 是一个强大的 ComfyUI 自定义节点,集成了 Google NanoBanana 的图像生成 API。支持文本到图像、图像到图像等多种生成模式,让你在 ComfyUI 工作流中轻松使用最新的 AI 图像生成技术。

大家好,我是李心宝,一个在电商设计领域摸爬滚打了多年的老设计。我专注在如何让 AI 技术真正在咱们的日常工作中落地,提升效率。我乐于分享自己深度评测、实践过、确实好用的 AI 工作流和设计技巧,希望能和大家一起探索、共同进步。我整理、制作了不少免费的工作流和资料,希望能帮你少走弯路。

当然,如果你需要更精细化、针对性更强的解决方案,我也提供付费的专属工作流。期待能和更多志同道合的设计人、电商人、AI实践者们交个朋友,一起把 AI 设计玩明白!

免费资料与专属工作流介绍

📂 点击访问飞书文档 - 获取免费资料及专属工作流详情

📺 视频教程

访问我的 B站主页 观看详细的使用教程和案例演示!

部分视频

📮 联系方式

✨ 功能特性

💡 关于批量/并发抽卡的小提示
节点支持一次最多生成 8 张图像,方便你快速“抽卡”拿到满意结果。但需要注意:在高并发/大批量(尤其是 8 张)的情况下,Google 官方有一定概率返回 finishReason=NO_IMAGE 的响应——即 API 调用请求成功且会正常计费,但本次响应体中不包含任何图片。这属于模型/服务端的行为,不是节点丢图。实测经验建议:
- 常规使用时将 batch_size 控制在 1-4 张 以内,兼顾效率与稳定性;
- 仅在明确接受“偶尔不返图但仍计费”的情况下再尝试 8 张高并发抽卡。

🚀 安装

方法 1: 通过 手动安装

cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li.git comfyui-banana-li
cd comfyui-banana-li

⚙️ 配置

1. 创建配置文件

复制或重命名示例配置文件并编辑:

cp config.ini.example config.ini

2. 填写 API Key

编辑 config.ini 文件:

[gemini]
# 你的 API Key
api_key = YOUR_API_KEY_HERE

# balance_cost_factor 已废弃, 保留默认值即可
balance_cost_factor = 0.6

# 最大并发工作线程数(建议 4-8,主要影响本地 CPU 解码/处理并发)
max_workers = 4

# 网络并发上限(同时发起的网络请求数量,范围 1-8)
# - 网络稳定/内网环境: 建议 4
# - 网络不稳定/代理/VPN/转发服务商: 建议 2-3
network_workers_cap = 4

# Keep-Alive 超时时间(已不再用于连接管理,可忽略)
keepalive_timeout = 30

3. 获取 API Key

你可以通过以下方式获取 NanoBanana API Key:

📝 使用方法

  1. 在 ComfyUI 中添加 "心宝❤Banana" 节点
  2. 配置节点参数(见下方参数说明)
  3. 连接其他节点并运行工作流

基础示例

文本提示词 → 心宝❤Banana → 预览图像 → 保存图像

图生图示例

加载图像 → 心宝❤Banana → 预览图像
         ↗  (image_1 输入)
文本提示词

🎛️ 参数说明

必需参数

参数 类型 默认值 说明
prompt STRING "Peace and love" 文本提示词,支持多行输入
api_key STRING "" Gemini API Key(留空则从配置文件读取)
model_type SELECT gemini-2.5-flash-image 固定选项: gemini-2.5-flash-image / gemini-3-pro-image-preview
batch_size INT 1 批量生成数量(1-8)
aspect_ratio STRING Auto 宽高比(Auto/1:1/9:16/16:9/21:9/2:3/3:2/3:4/4:3/4:5/5:4)

可选参数

参数 类型 默认值 说明
seed INT -1 随机种子(-1 为随机,0-102400 为固定)
top_p FLOAT 0.95 采样参数,控制生成多样性(0.0-1.0)
image_size SELECT 2K 仅 gemini-3-pro-image* 生效, 可选 1K/2K/4K
禁用SSL验证 BOOLEAN False 禁用提高成功率,但流量被第三人劫持状况下可能泄露密钥
image_1~5 IMAGE - 可选的参考图像输入(最多 5 张)

提示: 仅在可信的代理/内网环境中才建议打开“禁用SSL验证”,否则存在被中间人窃取 API Key 的风险。

📋 输出

节点返回一个包含生成图像的张量(TENSOR),可以连接到:

🔧 高级功能

并发控制

在 config.ini 中可以配置两类并发相关参数:

错误处理

当生成失败时,节点会:

  1. 自动重试(最多 3 次,指数退避)
  2. 如果所有重试都失败,返回包含错误信息的可视化图像
  3. 在控制台输出详细的错误日志

余额监控

节点内置 Web UI 扩展,可以在 ComfyUI 界面中实时查看:

🛠️ 开发

项目结构

banana/
├── __init__.py                    # 节点注册入口
├── Gemini_Imagen_Generator.py    # 主节点实现
├── logger.py                      # 日志系统
├── config.ini                     # 配置文件(需自行创建)
├── config.ini.example             # 配置模板
├── web/
│   └── extensions/
│       ├── token-balance.js       # 余额显示扩展
│       └── xinbao.png            # 图标
├── .gitignore
├── README.md
└── LICENSE

依赖库

❗ 注意事项

  1. API Key 安全:
  2. 费用控制:
  3. 性能优化:

🐛 故障排除

问题:无法加载节点

解决方案:

问题:API 请求失败

解决方案:

问题:生成速度慢

解决方案:

🤝 贡献

欢迎提交 Issue 和 Pull Request!

📄 许可证

本项目采用 MIT License 开源协议。

🙏 致谢


⭐ 如果这个项目对你有帮助,请给个 Star!

Made with ❤️ by 心宝