概述
ComfyUI-Nano-Banana-apiyi 是社区用户贡献的 ComfyUI 自定义节点集合，专为 API易 用户打造。它让你在 ComfyUI 工作流中直接调用谷歌最强图像生成模型 Nano Banana Pro 和 Nano Banana 2，无需配置谷歌云账号，只需 API易 密钥即可开始创作。项目信息
- 🔗 开源地址：
github.com/anirudhatalmale6-alt/ComfyUI-Nano-Banana-apiyi - 📜 许可证：MIT
- 👤 作者：anirudhatalmale6-alt
- ⭐ 该项目由社区用户贡献，专为 API易 适配
为什么选择这个节点
零门槛接入
无需谷歌云账号，使用 API易 密钥即可调用 Nano Banana Pro 和 Nano Banana 2 模型
多模态生图
支持文生图、图生图、多图融合（最多 14 张参考图），满足各类创作需求
多轮对话编辑
独创对话式图像生成，支持上下文记忆，逐步迭代优化图片效果
超高分辨率
支持 512px、1K、2K、4K 输出，14 种宽高比，覆盖海报、壁纸、社交媒体等各种场景
支持的 API易 模型
四大核心节点
本插件提供 4 个功能节点，覆盖不同的使用场景：| 节点名称 | 对应模型 | 核心能力 | 适合场景 |
|---|---|---|---|
| Nano Banana AIO | Pro | 文生图 + 图生图（1-6张参考图）+ 搜索增强 | 高质量创作 |
| Nano Banana Multi-Turn Chat | Pro | 多轮对话式图像编辑 | 迭代优化 |
| Nano Banana 2 AIO | Flash | 文生图 + 图生图（最多14张参考图）+ 图像搜索 | 快速批量生图 |
| Nano Banana 2 Multi-Turn Chat | Flash | 多轮对话式编辑 + 极端宽高比 | 快速迭代 |
从零开始：安装与配置
第四步：获取 API易 密钥
- 访问 API易控制台 注册/登录
- 进入【令牌】栏目
- 点击生成新的 API 密钥
- 复制密钥（以
sk-开头）备用
新用户注册即可获得免费测试额度，足够体验 Nano Banana 图像生成功能。
实战教程：从文字到图片
场景一：文字生成图片（最基础）
这是最简单的用法——输入一段文字描述，生成一张图片。设置参数
- image_count：生成图片数量（1-10张）
- aspect_ratio：选择宽高比，如
16:9（横屏壁纸）或9:16（手机壁纸） - image_size：选择分辨率，推荐
2K或4K - temperature：创意程度，0.0 最保守，2.0 最天马行空
场景二：图片编辑与融合
使用参考图片来引导生成，适合风格迁移、元素融合等高级用法。- 将 Nano Banana AIO 节点的
image_1到image_6输入端连接你的参考图片 - 在
prompt中描述你想要的效果，例如：“将这张照片转换为水彩画风格” - 模型会结合参考图片和文字描述生成新图片
场景三：多轮对话式编辑
这是 Nano Banana 节点最独特的功能——像聊天一样逐步优化图片。- 添加 Nano Banana Multi-Turn Chat 节点
- 第一轮：输入初始描述，生成基础图片
- 第二轮：输入修改指令，如”把背景换成海边”
- 第三轮：继续优化，如”增加夕阳光效”
- 每一轮都会基于之前的对话记忆进行修改
reset_chat 选项清除对话历史。
节点参数详解
Nano Banana AIO / Nano Banana 2 AIO
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | 图片描述文本 |
image_count | integer | 否 | 生成图片数量（1-10），默认 1 |
aspect_ratio | enum | 否 | 宽高比（11种 / NB2 支持14种） |
image_size | enum | 否 | 分辨率：512px（仅NB2）、1K、2K、4K |
temperature | float | 否 | 创意温度 0.0-2.0 |
use_search | boolean | 否 | 启用 Google 搜索增强 |
image_1 ~ image_6/14 | image | 否 | 参考图片输入 |
支持的宽高比
| 标准宽高比（两个节点共享） | Nano Banana 2 独有 |
|---|---|
| 1:1、2:3、3:2、3:4、4:3 | 1:4（超长竖图） |
| 4:5、5:4、9:16、16:9 | 4:1（超宽横图） |
| 21:9、Auto（AI自动选择） | 1:8、8:1（极端比例） |
常见问题
安装后在 ComfyUI 中找不到节点怎么办？
安装后在 ComfyUI 中找不到节点怎么办？
请逐项检查：
- 插件文件夹是否在
ComfyUI/custom_nodes/目录下 - 是否执行了
pip3 install -r requirements.txt - 使用 Nano Banana 2 节点需额外执行
pip install google-genai --upgrade - 是否重启了 ComfyUI（不是刷新网页，是重启后端服务）
生成图片时报错 API Key 无效？
生成图片时报错 API Key 无效？
请确认：
.env文件中的GOOGLE_API_KEY填写的是 API易 密钥（以sk-开头）CUSTOM_BASE_URL设置为https://api.apiyi.com- API易 账户余额充足（登录控制台查看）
生成速度慢或超时？
生成速度慢或超时？
- 4K 分辨率生成时间较长，建议先用 1K 调试效果
- 多图生成（image_count 大于 1）会增加耗时
- 如果频繁超时，可尝试降低分辨率或减少生成数量
Nano Banana Pro 和 Nano Banana 2 该选哪个？
Nano Banana Pro 和 Nano Banana 2 该选哪个？
- Nano Banana Pro（
gemini-3-pro-image-preview）：画质更精细，适合高品质创作 - Nano Banana 2（
gemini-3.1-flash-image-preview）：速度更快、成本更低（$0.018/张起），支持更多参考图和极端宽高比 - 日常创作推荐 Nano Banana 2，追求极致质量选 Pro
如何获取 API易 密钥？
如何获取 API易 密钥？
访问 API易控制台，注册账号后在【令牌】栏目生成新的密钥。新用户有免费测试额度。
图片生成失败，提示内容安全限制？
图片生成失败，提示内容安全限制？
Nano Banana 模型内置内容安全检查，部分描述可能触发限制。建议：
- 调整提示词，避免敏感内容
- 查看 Nano Banana 生图失败排查 获取更多帮助