<img src="https://img.shields.io/badge/Bilibili-ff69b4?logo=bilibili&logoColor=white" align="center" style="vertical-align: middle;"> 香蕉100%不偏移技巧,效率提升N倍
<img src="https://img.shields.io/badge/Bilibili-ff69b4?logo=bilibili&logoColor=white" align="center" style="vertical-align: middle;"> 心宝顶级放大系列-03人像类放大
<img src="https://img.shields.io/badge/Bilibili-ff69b4?logo=bilibili&logoColor=white" align="center" style="vertical-align: middle;"> 心宝顶级放大05-100%修手修脚
<img src="https://img.shields.io/badge/Bilibili-ff69b4?logo=bilibili&logoColor=white" align="center" style="vertical-align: middle;"> 4K透溶V2——纠正背景透视,一键换背景、融合、打光

📮 联系方式

GitHub Issues: 提交问题和建议
Bilibili: @心宝 - 视频教程和更新动态
获取公开资料及API 购买: <img src="https://img.shields.io/badge/WeChat-07C160?logo=wechat&logoColor=white" align="center" style="vertical-align: middle;"> 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！

</div>