Banana 是一个强大的 ComfyUI 自定义节点,集成了 Google NanoBanana 的图像生成 API。支持文本到图像、图像到图像等多种生成模式,让你在 ComfyUI 工作流中轻松使用最新的 AI 图像生成技术。
大家好,我是李心宝,一个在电商设计领域摸爬滚打了多年的老设计。我专注在如何让 AI 技术真正在咱们的日常工作中落地,提升效率。我乐于分享自己深度评测、实践过、确实好用的 AI 工作流和设计技巧,希望能和大家一起探索、共同进步。我整理、制作了不少免费的工作流和资料,希望能帮你少走弯路。
当然,如果你需要更精细化、针对性更强的解决方案,我也提供付费的专属工作流。期待能和更多志同道合的设计人、电商人、AI实践者们交个朋友,一起把 AI 设计玩明白!
📂 点击访问飞书文档 - 获取免费资料及专属工作流详情
访问我的 B站主页 观看详细的使用教程和案例演示!
💡 关于批量/并发抽卡的小提示
节点支持一次最多生成 8 张图像,方便你快速“抽卡”拿到满意结果。但需要注意:在高并发/大批量(尤其是 8 张)的情况下,Google 官方有一定概率返回finishReason=NO_IMAGE的响应——即 API 调用请求成功且会正常计费,但本次响应体中不包含任何图片。这属于模型/服务端的行为,不是节点丢图。实测经验建议:
- 常规使用时将batch_size控制在 1-4 张 以内,兼顾效率与稳定性;
- 仅在明确接受“偶尔不返图但仍计费”的情况下再尝试 8 张高并发抽卡。
cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li.git comfyui-banana-li
cd comfyui-banana-li
复制或重命名示例配置文件并编辑:
cp config.ini.example config.ini
编辑 config.ini 文件:
[gemini]
# 你的 API Key
api_key = YOUR_API_KEY_HERE
# Token 换算人民币调节系数(请勿调整,影响准确性)
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
你可以通过以下方式获取 NanoBanana API Key:
文本提示词 → 心宝❤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 中可以配置两类并发相关参数:
max_workers: 本地 CPU 侧的解码/处理并发度
network_workers_cap: 网络并发上限(同时发起的网络请求数量,范围 1-8)
当生成失败时,节点会:
节点内置 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
config.ini 或含有apikey的工作流公开泄露batch_size 避免过度消耗max_workers解决方案:
解决方案:
解决方案:
batch_sizemax_workers 参数欢迎提交 Issue 和 Pull Request!
本项目采用 MIT License 开源协议。
⭐ 如果这个项目对你有帮助,请给个 Star!
Made with ❤️ by 心宝