本文系统讲解 Windows 系统下 ComfyUI 的多种安装方式、GrsAI 插件部署流程、API Key 配置方法，同时介绍 Nano Banana Pro 等模型调用规则与批量生图功能，并汇总常见故障排查方案。文中所需 Git、ComfyUI 主程序、插件等全部资源均已整合至指定百度网盘，便于统一下载部署。

一、前置说明与相关平台介绍

1.1 插件更新说明

本次 GrsAI 配套 ComfyUI 插件完成版本迭代，主要更新内容如下：

1. 新增cl、vip两类模型调用渠道，扩充可用模型范围；
2. 支持单次生成 1~12 张图片的批量生图能力；
3. 优化 API Key 配置逻辑，无需手动修改配置文件，可直接在插件节点内填写密钥；
4. 安全提醒：分享操作截图时，务必对 API Key 进行打码处理，防止密钥泄露造成账号积分被盗刷。

1.2 GrsAI 平台简介

GrsAI 是专业 AI 大模型 API 服务供应商，提供海外主流 AI 绘图模型接口，服务稳定性强且支持高并发调用。平台涵盖 Nano Banana Pro、Nano Banana、Nano Banana 2、Gpt-image-2 等多款绘图模型，不同模型按照调用次数扣除对应积分，计费标准基于积分充值套餐核算。 模型完整参数、功能说明可查阅官方页面：https://grsai.ai/zh/dashboard/models

1.3 平台与工具访问地址

1. GrsAI 官网：https://grsai.ai（com后缀域名需特殊网络环境，ai后缀域名可正常直连）
2. GrsAI API 管理控制台：https://grsai.ai/zh/dashboard
3. ComfyUI 官方仓库：https://github.com/comfyanonymous/ComfyUI
4. ComfyUI 版本发布页：https://github.com/Comfy-Org/ComfyUI/releases
5. 问题咨询渠道：配置或使用遇到问题，可访问 https://grok.com/ 咨询；无特殊网络环境可选择 Deepseek。

1.4 统一资源下载地址

本次教程所需全部文件：
     Git-2.54.0-64-bit.exe
     ComfyUI windows_portable_nvidia.7z
     Comfy Desktop Setup 1.0.18-x64.exe
     ComfyUI-GrsAl-main.zip
     ComfyUI-Manager-main.zip
均已整合至百度网盘：
链接: https://pan.baidu.com/s/1YrZ1K9BukTJlriCAeiH8lg?pwd=8888 提取码: 8888

二、GrsAI 平台模型参数明细

下表汇总平台主流绘图模型的积分消耗、单次参考价格、支持功能及返还规则，便于选型使用：

补充说明：违规判定标准由模型提供方制定，与 GrsAI 平台无关。

三、Windows 系统 ComfyUI 三种安装方式

Windows 系统提供桌面安装包、官方便携版、命令行部署三种安装方案，可根据自身使用习惯与技术基础选择。硬件基础要求：推荐使用 NVIDIA 独立显卡，显存 6GB 及以上；AMD 显卡兼容性较差。

3.1 方式一：ComfyUI Desktop 桌面安装包（新手推荐）

该版本为标准桌面客户端，图形化安装流程，自动配置运行环境，操作门槛最低。

1. 从上方百度网盘下载文件 Comfy Desktop Setup 1.0.18-x64.exe；
2. 双击运行安装程序，按照软件安装向导，依次点击 Next、Install 完成安装；
3. 安装完成后，系统桌面会生成 ComfyUI Desktop 快捷方式；
4. 双击快捷方式启动程序，首次会执行初始化加载，等待片刻后浏览器将自动打开访问地址 http://127.0.0.1:8188，进入操作界面。

3.2 方式二：官方 Portable 便携版（使用率最高）

便携版为绿色免安装程序，内置完整运行依赖，解压即可使用，适合频繁迁移、不想写入系统注册表的用户。

1. 从百度网盘下载压缩包 ComfyUI windows_portable_ nvidia.7z；
2. 使用 7-Zip、WinRAR 等工具解压文件，建议解压至 D 盘、E 盘等非系统分区，路径尽量不包含中文、特殊字符；
3. 进入解压后的根目录，根据硬件选择启动脚本：
   • NVIDIA 独立显卡：双击 run_nvidia_gpu.bat；
   • 仅使用 CPU 运行：双击 run_cpu.bat；
4. 首次启动会自动下载少量依赖组件，等待加载完成；程序启动后自动唤起浏览器访问 http://127.0.0.1:8188，若未自动跳转，手动在浏览器输入该地址即可。

3.3 方式三：命令行部署（进阶 / 自动化用户使用）

该方式基于comfy-cli官方命令行工具，全程使用指令操作，适合习惯命令行、需要批量部署或自动化运维的场景。

1. 前置准备：从百度网盘下载 Git-2.54.0-64-bit.exe，双击安装 Git 程序，全程保持默认设置，安装完成后重启命令行工具；
2. 以管理员身份打开命令提示符（CMD）或 PowerShell，逐行执行以下指令：

# 创建专用存放文件夹（可选，建议单独分类）
mkdir C:\ComfyUI
# 进入目标目录
cd C:\ComfyUI
# 创建Python虚拟环境
python -m venv venv
# 激活虚拟环境
venv\Scripts\activate
# 后续根据提示执行comfy-cli安装指令，完成ComfyUI部署

1. 按照命令行界面提示完成剩余下载、配置与启动操作。

四、GrsAI API 插件完整安装流程

GrsAI 插件需依托 ComfyUI Manager 工具完成安装，本文提供在线搜索、Git 地址拉取、离线解压三种安装方式，优先推荐在线搜索方式。

4.1 第一步：安装 ComfyUI Manager

ComfyUI Manager 是 ComfyUI 专用节点管理工具，用于在线检索、安装、更新各类自定义插件。

1. 从百度网盘下载压缩包 ComfyUI-Manager-main.zip；
2. 解压文件，将完整文件夹复制到 ComfyUI 根目录下的 custom_nodes 文件夹内；
3. 关闭当前 ComfyUI 程序，重新双击启动脚本运行软件；
4. 程序重启后，界面右上角出现Manager菜单，代表工具安装成功。

4.2 第二步：安装 GrsAI API 插件

1. 从百度网盘下载压缩包 ComfyUI-GrsAl-main.zip；
2. 解压文件，将文件夹重命名为 ComfyUI-GrsAI；
3. 把重命名后的文件夹放入 ComfyUI 根目录的 custom_nodes 目录中；
4. 重启 ComfyUI 程序，插件自动生效。

4.3 第四步：界面操作

点击Manager

点击Custom Nodes Manager

输入 grsai 进行搜索找到GrsAI api in ComfyUI，然后点击Install

安装完后重启ComfyUI

打开 GrsAIAPi控制台：Dashboard

创建APi key：点击API Key栏目，创建后复制（可以设置额度，以防key泄露工作流出问题导致额度刷光）

在comfyui空白处右键，添加节点，找到GrsAi，选择模型，黏贴刚才复制的APikey即可使用

注意！！！截图的时候不要随意暴露自己的APIkey很容易被盗用！

五、批量生成图片功能使用说明

GrsAI 插件支持批量生图，单次任务可生成 1~12 张图片，具体操作与计费规则如下：

1. 在已配置好 API Key 的 GrsAI 模型节点中，找到num_images参数项；
2. 根据需求设置参数数值（取值范围 1~12），该数值即为单次任务的图片生成数量；
3. 选择目标模型、图片比例、分辨率，填写正向 / 反向提示词；
4. 点击界面「运行」按钮，启动批量生成任务。

计费规则：批量生图为插件延伸功能，无额外收费，每生成 1 张图片，扣除对应模型单次调用的积分，多张图片累计扣费。任务执行状态、积分消耗明细可在 GrsAI 控制台日志中查看。

六、常见问题与解决方案

6.1 生成图片为纯黑色画面

问题原因：模型接口调用超时、后台任务执行异常。 解决办法：登录 GrsAI 控制台，查看对应任务日志，确认任务实际执行状态；若日志显示任务执行成功但图片无法正常显示，可排查图片精度相关配置。

6.2 积分扣除相关疑问

1. 违规调用：cl、vip渠道的模型，触发平台违规规则会正常扣除积分，违规标准由模型提供方规定；
2. 调用失败：所有模型请求执行失败，均不会扣除账号积分。

6.3 提示 google gemini timeout

问题原因：模型接口临时不稳定、网络波动。 解决办法：切换至同系列其他渠道的模型，或间隔一段时间后重新发起生成请求。

6.4 访问节点地址出现 404 错误

问题描述：使用浏览器打开 grsai.dakka.com.cn、grsaiapi.com 等地址，页面提示 404。 说明：以上地址为程序接口节点，并非网页访问地址，无需使用浏览器打开，插件可正常调用，404 属于正常现象。

6.5 其他故障处理

若遇到上述未提及的使用问题，可进入 GrsAI 控制台帮助中心 https://grsai.ai/zh/dashboard/help，联系在线客服协助解决。