Extensions/SillyDream Banana Gemini Image Generator
ComfyUI Extension

SillyDream Banana Gemini Image Generator

通过任意 OpenAI/Gemini 兼容网关调用 NanoBanana(Gemini) 文生图/图生图，支持最多14张参考图、批量并发生成与端点延迟测速。

By qianchi7·Created 10 days ago·Updated 10 days ago· 0
qianchi7/ComfyUI-SillyDream-Banana
Nodes—
On cloudLocal install
Stars0
Updated10 days ago
Readme

ComfyUI-SillyDream-Banana — NanoBanana (Gemini) 文生图 / 图生图

通过任意 OpenAI/Gemini 兼容的云端网关调用 Google NanoBanana(Gemini) 图像生成能力，支持文生图、图生图（最多 14 张参考图）、批量并发生成、端点延迟测速。

如果感兴趣也可以试试注册我的官网：https://wish.sillydream.top

包含两个节点：

  • Banana Gemini Image Generator（分类 image/ai_generation）— 主生成节点
  • Banana Endpoint Tester（分类 Banana/tools）— 独立的 Base URL 测速节点，只 ping 不生图，方便正式跑图前先确认线路质量

安装

方式一：ComfyUI-Manager（推荐）

Manager → Install via Git URL，填入：

https://github.com/qianchi7/ComfyUI-SillyDream-Banana.git

装完点 Manager 里的 Restart（不要只点 Reload）。以后作者更新代码，在 Manager 里点该节点的 Update 按钮即可（本质是 git pull）。

方式二：手动 clone

cd ComfyUI/custom_nodes
git clone https://github.com/qianchi7/ComfyUI-SillyDream-Banana.git
pip install requests

配置

首次启动会在节点目录下自动生成一份 config.ini 示例：

[gemini]
api_key = your-api-key-here
api_base_url = http://your-gateway:port
max_workers = 4
network_workers_cap = 4
  • api_key / api_base_url 换成你自己的；也可以不改 config.ini，直接在节点面板里临时填写，节点输入优先于 config.ini
  • max_workers / network_workers_cap：批量生成时的并发上限
  • 可选 bypass_proxy = true：绕过本机系统代理直连

示例工作流

装好后顶部菜单 工作流 → 浏览模板 (Browse Templates)，选 NanoBanana-API-V3.5 即可加载，无需手动拖 json。工作流会随 git pull 一起更新。

（example_workflows/ 目录里的 json 也可以直接拖进网页界面。）

节点参数（Banana Gemini Image Generator）

| 参数 | 说明 | |------|------| | prompt | 生成图像的文本提示词，支持多行 | | api_key | 你自己网关对应的 API Key，留空则回退使用 config.ini 中的配置 | | api_base_url | 你自己的 API 服务地址，留空则回退使用 config.ini 中的配置 | | model_type | 模型名称，需与你所用网关中配置的模型名一致 | | batch_size | 单次请求生成的图片数量，1~8 | | aspect_ratio | 输出图像宽高比，Auto 由服务端自动决定，也可从内置的常见比例中选择 | | seed | 随机种子，-1 为自动随机 | | top_p | 采样参数 Top-P | | imageSize | 分辨率档位：无 / 1K / 2K / 4K | | image_1~image_14 | 最多 14 张参考图输入，用于图生图或多图融合 | | 超时秒数 / 无限超时 | 请求读取超时设置；开启「无限超时」时忽略「超时秒数」 | | 绕过代理 | 本机代理不稳定时可开启，绕过系统代理直连 | | 测试延迟 / ping次数 | 开启后先对当前 Base URL 做 ping 测速，输出延迟和丢包率，便于挑选更稳定的节点线路 |

故障排除

❌ 装好了但搜不到节点

  • 必须重启 ComfyUI（不是刷新网页），custom_nodes 只在启动时扫描一次
  • 看终端日志有没有 Traceback / ImportError / ModuleNotFoundError，多半是缺依赖
  • 便携版装依赖要用 python_embeded\python.exe -m pip install requests

❌ 无法连接到服务器 / Connection error

  • 确认 api_base_url 能从本机浏览器/curl 正常访问
  • 尝试开启「绕过代理」，或先用 Banana Endpoint Tester 测速

❌ HTTP 4xx / 5xx

  • 401/403：检查 api_key 是否正确、该 Key 是否有权限访问所填模型
  • 404：检查 model_type 是否与网关中配置的名称完全一致
  • 429：请求过于频繁，稍后重试
  • 502/503：上游模型服务或网关本身异常，可尝试更换 api_base_url

❌ 生成结果里图片是空的 / 只有文字

  • 部分模型在遇到内容策略限制时只会返回文字说明，节点会把该说明附带输出在 text 里，可据此调整提示词

协议

MIT License

来源与致谢

本节点基于 xinbao 的 comfyui-banana-li 二次开发。 原项目以 MIT 协议发布，其版权声明已按协议要求保留在 LICENSE 中。 本仓库在其基础上做了改动（新增端点延迟测速节点、批量并发调度、移除原代码中隐藏的后台地址切换逻辑等），修改部分版权归 qianchi7 所有。