ComfyUI 接入 Gemini 教程：Nano Banana 2.1 官方节点与积分计费

在 ComfyUI 里用 Google 的 Nano Banana 图像模型，现在最省事的做法是用 ComfyUI 自带的 Nano Banana 2.1 节点：把 ComfyUI 更新到 0.39.1 或更高版本，在设置里登录 Comfy 账号、充值积分，双击画布搜「Nano Banana 2.1」或打开模板库里的「文本到图像」「图像编辑」模板就能出图。这个节点属于 ComfyUI 官方的 Partner Nodes，费用从 Comfy 积分里扣，不需要 Google API 密钥，也不用开通 Google Cloud 结算。

如果你的工作流是 2026 年上半年搭的，先看第二节：gemini-3.1-flash-image-preview 和 gemini-3-pro-image-preview 两个预览模型 ID 已在 2026 年 6 月 25 日从 Gemini API 停用，还在请求这两个名字的节点会直接报错。

2026 年 10 月 8 日更新：原文围绕 gemini-3.1-flash-image-preview 和社区自定义节点写成，现在改为以官方 Nano Banana 2.1 节点为主线；补上旧工作流的迁移方法和 Comfy 积分价格；原来对比的 5 个社区节点，截至 2026 年 10 月 8 日没有一个能用现行模型 ID，相关安装步骤已删除。

ComfyUI 接入 Nano Banana 用哪个节点：官方 Nano Banana 2.1 节点

截至 2026 年 10 月 8 日，在 ComfyUI 里调用 Nano Banana 有两条路，适用的人不同：

第二条路的问题在于节点本身：早先常被推荐的 5 个社区节点，截至 2026 年 10 月 8 日要么仓库已经打不开，要么代码里只写着已停用的模型 ID（详见下一节的表）。所以除非你自己维护节点代码，ComfyUI 里能直接用上 Nano Banana 2.1 的只有官方节点。

官方节点的模型下拉菜单里有三个选项，按 Comfy 的 Nano Banana 2.1 教程的划分：

• Nano Banana 2.1（gemini-nano-banana-2.1）：1K/2K/4K，思考等级 MINIMAL、MEDIUM、HIGH，Comfy 把它定位为版面和细节要求高的生成与编辑。Google 已在 2026 年 10 月 6 日将它正式发布，新项目推荐用它。
• Nano Banana 2（gemini-3.1-flash-image）：1K/2K/4K，思考等级只有 MINIMAL 和 HIGH。它在 Gemini API 上已被标为弃用、尚未公布停用日期。
• Nano Banana 2 Lite（gemini-3.1-flash-lite-image）：只有 1K，最快、最便宜，适合打草稿和大批量试图。

Nano Banana Pro（gemini-3-pro-image）不在这个下拉菜单里，要用单独的「Nano Banana Pro (Google Gemini Image)」节点。怎么在 2.1 和 Pro 之间选：海报、菜单这类要求文字一字不差的图，在 Nano Banana 2.1 vs Pro vs GPT Image 2.5 对比：9 组同题实测里，Pro 保住了指定文字，2.1 在三道文字题上都改了字；不涉及精确文字的图，2.1 便宜得多。四个型号的定位差异见 Nano Banana 2、2.1、Pro 和 Lite 区别怎么选。

旧工作流报错：gemini-3.1-flash-image-preview 已于 6 月 25 日停用

Google 的 Gemini API 弃用时间表列出了三个已停用的 Nano Banana 预览 ID：

任何还在请求这些名字的代码或节点都会失败，和 ComfyUI 本身的版本无关。迁移按你用的节点分三种情况：

用的是社区自定义节点。 截至 2026 年 10 月 8 日，早先常被推荐的 5 个节点在 GitHub 上的状态如下：

这些节点没有发布支持新 ID 的版本。直接改节点源码里的模型名虽然可能指向 gemini-nano-banana-2.1 或 gemini-3.1-flash-image，但请求参数是否兼容没有维护者背书，生产工作流不建议这样做。更稳的做法是把工作流里的社区节点删掉，换成官方「Nano Banana 2.1」节点，原来的 Load Image、Save Image 等节点照旧连接；提示词可以原样复制过去。

用的是官方「Nano Banana Pro (Google Gemini Image)」节点。 更新 ComfyUI 后不用重建。Comfy 的 Nano Banana 2 教程说明 Nano Banana 2 也加进了这个节点，旧工作流只需重新选择模型版本。ComfyUI 当前源码里，这个节点下拉菜单中仍显示 gemini-3-pro-image-preview 字样，但实际发出请求时已换成正式版 gemini-3-pro-image。

用的是早期官方「Nano Banana 2」节点。 ComfyUI 源码里这个节点已标为弃用，它请求的仍是 gemini-3.1-flash-image-preview 这个名字。Comfy 文档没有说明它还能用多久，把它换成「Nano Banana 2.1」节点，在下拉菜单里选 Nano Banana 2 或 2.1 即可。

安装与登录：ComfyUI 0.39.1、Comfy 账号与积分

官方节点不需要 git clone 或 pip 安装，它随 ComfyUI 本体发布。按顺序做四件事：

1. 更新 ComfyUI 到 0.39.1 或更高版本。 「Nano Banana 2.1」节点和两个模板从这个版本开始提供，按 ComfyUI 更新指南操作。Comfy 建议在找不到新节点时用 nightly（开发版），稳定版有时会晚一步；Comfy Cloud 跟随稳定版更新。
2. 登录 Comfy 账号。 在「设置 → 用户」里登录。这是 Comfy 的账号，不是 Google 账号。
3. 充值积分。 登录后「设置」里会多出「积分」一项，在那里购买。付款走 Stripe，支持信用卡；付款页选择以 Comfy Credits 计价时还可以用微信或支付宝。积分是预付制，余额要大于 0 才能运行 Partner Nodes。
4. 打开模板。 双击画布搜索「Nano Banana 2.1」，或打开模板库选「文本到图像」（api_nano_banana_2_1_t2i）或「图像编辑」（api_nano_banana_2_1_image_edit）。

登录有一条容易踩的限制：Comfy 只允许在本机地址打开的 ComfyUI 页面里直接用账号登录。如果你用 --listen 让局域网里其他电脑访问，或者在不在 Comfy 白名单里的网站上使用，就要改用 Comfy 账号的 API Key 登录，具体步骤见 Comfy 的 Partner Nodes 说明。Comfy 还要求在 https 环境下访问，并提到在某些地区可能需要使用代理服务才能连上它的 API 服务。这里的 API Key 是 Comfy 账号的密钥，Partner Nodes 目前不支持填自己的 Google 密钥。

积分本身有几条规则，买之前值得知道：

• 充值获得的积分 1 年后过期，订阅附带的月度积分在当期结束时过期。
• 未用完的积分不退款。
• 一次运行的实际花费可能超过剩余余额，余额会暂时变成负数；负数期间不能再运行 Partner Nodes，充值转正后恢复。
• 用量和扣费明细在「设置 → 积分」里的使用记录中查看，运行前节点上的价格标签会显示预估花费。

Nano Banana 2.1 节点参数：分辨率、思考等级、宽高比与 seed

节点上影响结果和费用的设置如下，取值来自 Comfy 的 Nano Banana 2.1 教程：

seed 需要单独说明。Comfy 文档写的是「固定一个值可以让重复运行尽量接近」，但 ComfyUI 当前源码里，「Nano Banana 2.1」节点发给 Google 的请求里并不包含 seed；Google 的 Vertex AI 文档也写明，给 2.1 传 seed 会返回错误。所以在 2.1 上固定 seed 不能保证画出同一张图。需要多张一致的画面时，靠参考图和写清楚的提示词来约束，比依赖 seed 可靠。

思考等级会同时影响速度和费用。草稿阶段用 MINIMAL 快速出图；版面复杂、元素多、需要模型先理清布局时再切到 MEDIUM 或 HIGH。

三个常用 ComfyUI 工作流：文生图、图片编辑、多张参考图

下面三个工作流都只用到官方节点和 ComfyUI 自带的基础节点，可以从模板开始改。

文生图：Nano Banana 2.1 节点直接接 Save Image

文生图不需要任何输入文件：提示词是唯一输入，aspect_ratio 决定画面形状，结果保存为 PNG。在模板库打开「文本到图像」，或者手动搭：

[Nano Banana 2.1] → [Save Image]
  ├─ model: Nano Banana 2.1
  ├─ prompt: "画面描述"
  ├─ resolution: 1K
  ├─ aspect_ratio: 1:1
  └─ thinking_level: MINIMAL（草稿）/ MEDIUM（定稿）

先用 1K、MINIMAL 把构图和风格试对，再把定稿换成 2K 或 4K。社交媒体配图、网页插图最后多半缩到 1,000 像素左右，直接出 4K 等于为用不到的像素付费。

图片编辑：Load Image 接到节点的参考图输入

编辑现有图片时，把图加载进 Load Image 节点，连到 Nano Banana 2.1 节点的参考图输入，再在提示词里写要改什么。官方「图像编辑」模板还额外接了一个 Image Compare 节点，可以在同一画布上对比原图和结果。

[Load Image] → [Nano Banana 2.1] → [Image Compare] / [Save Image]
                 └─ prompt: "具体的修改指令"

编辑指令越具体、越有空间定位，结果越可控。「让它更好看」这类模糊指令结果难以预测；「把木桌换成玻璃茶几，保持原来的大小和位置」「把背景换成深色，从正面打冷蓝光、从背后打暖琥珀色轮廓光」这类指令更容易得到预期的修改。产品图换背景、室内图换材质时，同一张底图可以反复改，不用从头生成。

多张参考图：统一风格或角色

节点一次最多接 14 张参考图，用来约束主体、风格或版面。用多个 Load Image 节点加载参考图，全部连到同一个 Nano Banana 2.1 节点，再用提示词描述要生成的新内容，并说明每张参考图的作用（例如「参考图 1 的人物，参考图 2 的配色」）。

[Load Image 1] ─┐
[Load Image 2] ─┤→ [Nano Banana 2.1] → [Save Image]
[Load Image 3] ─┘    ├─ prompt: "新画面描述 + 各参考图的用途"
                     └─ aspect_ratio: auto（跟随第一张参考图）

aspect_ratio 选 auto 时跟随第一张参考图，想要固定比例就显式选择。每多一张参考图，输入 token 就多一些，积分也会相应增加。

这三种工作流都可以和本地节点混用，例如先用本地模型出底图，再交给 Nano Banana 2.1 改细节，或者把它的输出接到本地放大节点。

ComfyUI 里出一张 Nano Banana 图要多少积分：2.1 的 1K 约 10 积分

Comfy 的 Partner Node 定价页按 token 计价，单位是积分，没有给出积分和美元的换算。截至 2026 年 10 月 8 日的价格（每 1K token）：

按 token 计价不方便估算每张图，可以借 Google Gemini API 价格页公布的每张图 token 数换算：2.1 的 1K、2K、4K 图分别消耗 1,120、1,680、3,780 个 token；Nano Banana 2 分别是 1,120、1,680、2,520；Pro 的 1K/2K 是 1,120、4K 是 2,000；Lite 的 1K 是 1,120。

每张图的图片输出积分 ≈ token 数 ÷ 1,000 × 图片输出单价

这张表只算了图片输出，假设 Comfy 计的 token 数与 Google 公布的一致；提示词、参考图（输入）和思考内容（文本输出）另计，实际花费以节点上的价格标签和积分使用记录为准。从表里能看出三件事：

• 2.1 比 Nano Banana 2 便宜，但在 ComfyUI 里省得比 Google 官方价少。 1K 和 2K 上 2.1 约为 NB2 的 60%（10.1 ÷ 17.0），省约 40%；4K 上约为 89%（34.2 ÷ 38.3），只省约 11%。同样的比较放在 Gemini API 官方价上，1K 是 $0.0336 对 $0.067，省约 50%；4K 是 $0.113 对 $0.151，省约 25%。
• Pro 的 1K 约是 2.1 的 3.4 倍（34.0 ÷ 10.1）。只有确实需要 Pro 的文字准确度时才值得用。
• 2.1 的思考内容更贵。 它的文本输出单价 2.263 约是 NB2（0.7596）的 3 倍，而 2.1 默认就是 MEDIUM 思考。以 1,000 个思考 token 为例，2.1 多扣约 2.3 积分，接近一张 1K 图片输出的四分之一。草稿阶段把思考等级调到 MINIMAL，是 ComfyUI 里最直接的省积分办法。

上图是 2026 年 3 月为 Nano Banana 2 画的美元成本图。蓝色一组仍是现在 gemini-3.1-flash-image 在 Gemini API 上的标准价（0.5K $0.045、1K $0.067、2K $0.101、4K $0.151），紫色一组是 Batch 半价；绿色一组是 laozhang.ai 当时的按次价，现在已调整为每次 $0.055，它不是 ComfyUI 节点的计费方式。另外两点要注意：Batch 半价只适用于自己写代码调用 Gemini API 的 Batch 模式，ComfyUI 节点是逐次同步请求，用不上；Nano Banana 2.1 的官方价（1K $0.0336、2K $0.0504、4K $0.113）不在图里。2.1 的美元价格和入口见 Nano Banana 2.1 价格与入口，Nano Banana 2 的完整价目见 Nano Banana 2 API 价格，Pro 见 Gemini 3 Pro Image API 定价 2026。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

用自己的 Google API 密钥：没有免费层，中国大陆不在支持地区

如果你已经有 Google 的结算账户，想按 Google 官方价付费，也可以走 Gemini API；打算用 Pro 的话，官方 API 按张怎么计价、和 Google AI Pro 订阅费有什么区别，见 Nano Banana Pro 多少钱？API、订阅与每张合格图成本。动手前先确认三件事：

• 没有免费出图额度。 Gemini API 的图片模型不提供免费层，项目必须先在 Google Cloud 关联结算账户才能出图；未开通结算时调用图片模型会被拒绝，各类报错的含义见 Gemini 图片生成 429 速率限制，免费额度的现状见 Gemini 图片生成 API 免费吗。
• 地区限制。 Google 的 Gemini API 可用地区列表（2026 年 4 月 28 日更新）不包含中国大陆和香港。
• ComfyUI 里缺少能用的节点。 官方 Partner Nodes 不接受自己的 Google 密钥，上一节表里的社区节点又都没有支持现行模型 ID。走这条路意味着你要自己维护节点代码，或者在 ComfyUI 之外写脚本调用，再把生成的图导入工作流。

上图的四个步骤仍然适用：在 Google AI Studio 创建 API 密钥，到 Google Cloud Console 的「结算」里给项目关联付款方式，再用环境变量把密钥交给节点，不要把密钥直接写进工作流 JSON，导出分享时会一并带出去。图中提到的 gemini-3.1-flash-image-preview 已经停用，请换成 gemini-nano-banana-2.1；底部那条替代方案说的也是这个旧 ID。

自己写代码调用时，模型选择和代码示例见 Nano Banana API 教程；在 Vertex AI 上调用（2.1 只在 global 区域提供，且不支持 Flex）见 Vertex AI 调用 Nano Banana。Nano Banana 2 在 Gemini API 上已弃用、尚无停用日期，在 Vertex AI 上的退役日期则是 2027 年 5 月 28 日或更晚；新项目直接用 2.1 可以少迁移一次。

另外，Comfy 账号和积分也能在 ComfyUI 之外使用：Comfy Router 通过 HTTP 提供 vertexai/gemini-nano-banana-2.1，与 ComfyUI 里扣同一份积分。只想用积分、又需要写脚本批量出图时，可以看 Comfy 文档里的调用示例。

Nano Banana 2.1 节点常见报错与排查

搜不到「Nano Banana 2.1」节点，或打开模板提示缺节点。 几乎都是 ComfyUI 版本低于 0.39.1。更新后仍然找不到，换 nightly 版本再试；启动日志里有节点导入失败的报错时，先处理那条报错。Comfy Cloud 用户要等下一次稳定版发布。

节点一直要求登录，或登录后仍然无法运行。 按顺序排查：页面是不是从本机地址打开的（局域网访问或非白名单网站要改用 Comfy API Key 登录）；是否在 https 环境下访问；积分余额是否大于 0；网络能否正常连到 Comfy 的 API 服务。

积分变成负数后节点无法运行。 上一次运行的实际花费超过了剩余余额。充值让余额回到正数即可恢复，之后在运行 4K 或 HIGH 思考这类耗积分的任务前留够余额。

旧工作流报「找不到模型」一类的错误。 检查节点发出的模型 ID 是否是已停用的预览版，按第二节换成官方「Nano Banana 2.1」节点，或在官方 Pro 节点里重新选择模型版本。

固定了 seed，结果每次还是不同。 2.1 节点不会把 seed 发给 Google，这是预期行为。要保持一致，用参考图约束主体，并把构图、配色、镜头写进提示词。

出图很慢。 先看思考等级：MEDIUM 和 HIGH 会让模型先推理再画，速度明显慢于 MINIMAL；4K 也比 1K 慢。在不经过 ComfyUI 的 9 组同题测试里，2.1 出一张 1K 图约 20 秒；经由 ComfyUI 时还要加上 Comfy 服务这一层的往返。

没有出图或返回空结果。 Partner Nodes 会把提示词和图片发给模型提供方，由提供方执行自己的内容审核；涉及暴力、色情或真实公众人物的内容可能被拦下。调整提示词措辞后重试，不要提交违规内容。

以上都是 ComfyUI 节点这一侧的问题。在 ComfyUI 之外用自己的密钥直接调用 Gemini API 时遇到 503 过载、安全拦截这类报错，可以对照 Nano Banana Pro 错误排查中心里按错误代码列出的处理办法。

下一步：从 1K 模板跑通，再按需求调分辨率和模型

把 ComfyUI 更新到 0.39.1 以上，登录 Comfy 账号、买少量积分，打开「文本到图像」模板，用 1K、MINIMAL 跑通第一张图；再试「图像编辑」模板，确认参考图的效果。旧工作流里的社区节点或早期「Nano Banana 2」节点逐个换成「Nano Banana 2.1」节点。定稿需要更高分辨率时再升到 2K 或 4K，需要文字完全准确时换 Pro 节点，并在「设置 → 积分」的使用记录里核对每类任务实际扣了多少积分。