ComfyUI-GrsAI

December 23, 2025 · View on GitHub

强大的多模型图像生成 ComfyUI 自定义节点,使用GrsAI官方API,支持文生图、图生图、多图融合和批量生图。 支持多种主流模型,价格低至¥0.02/次。

🚀 概述

ComfyUI-GrsAI 是一个专业的 ComfyUI 扩展,提供完整的多模型图像生成功能。支持多种主流AI模型,经过深度优化,为用户提供最简洁的配置体验和最强大的功能支持。

📸 功能演示

🎨 文生图模式

使用 GrsAI - Text to Image 节点,纯文本生成高质量图像:

文生图演示

生成效果:基于文字描述创建的老虎眼睛特写,细节丰富,质感逼真

🖼️ 图生图模式

使用 GrsAI - Image to Image 节点,基于输入图像进行智能编辑:

图生图演示

生成效果:基于提示词"坐在沙发上的角色和达尔马提亚犬",同时生成4张不同变化的图像

🎭 多图融合模式

使用 GrsAI - Multi Image Fusion 节点,融合多个参考图像:

多图融合演示

复杂工作流:使用多个参考图像(人物+小狗)进行智能融合,创造出和谐统一的场景

✨ 核心特性

  • 🎨 四种生成模式 - 文生图、图生图、多图融合、批量生图,满足所有创作需求
  • 🔥 多模型支持 - 从经济实惠的GPT Image到专业的Flux系列与 Nano Banana(含 nano-banana-pro)
  • 批量生成 - 支持批量生图,智能并发提升效率
  • 🛡️ 零技术门槛 - 只需一个API密钥,自动处理所有技术细节
  • 🎯 专业参数控制 - 完整支持种子、指导强度、推理步数、宽高比等参数
  • 🌟 优雅的用户界面 - 简洁的状态反馈,清晰的生成进度提示

🍌 Nano Banana 支持

全新支持 Nano Banana 图像生成模型,提供高效的文生图与图生图能力:

  • 节点名称: 🍌 GrsAI Nano Banana - Text/Image
  • 模型选项: nano-banana-fastnano-banananano-banana-pronano-banana-pro-vt
  • 输入方式:
    • 仅填写 prompt 为文生图
    • 连接 1–6 张参考图像端口为图生图/多图融合
  • 输出: image(生成图像)与 status(状态文本)
  • 可选参数:
    • 通过 使用宽高比 勾选框决定是否传入 aspectRatio
    • 宽高比列表支持 auto1:116:99:164:33:43:22:35:44:521:9
    • nano-banana-pro / nano-banana-pro-vt 支持 imageSize(1K/2K/4K,默认 1K),在其他模型上会被忽略

使用步骤(ComfyUI 内):

  1. 搜索并添加节点 🍌 GrsAI Nano Banana - Text/Image
  2. 填写提示词 prompt,根据需要选择 model
  3. 可选:勾选 使用宽高比 并选择列表中的宽高比值
  4. 可选:接入 1–6 张参考图像以进行编辑/融合
  5. 运行并查看输出图像与状态信息

🔥 项目优势

  • 🔑 超简化配置 - 仅需配置GrsAI密钥,无需额外的第三方服务配置
  • 📱 友好的反馈 - 中文界面,emoji状态提示,清晰的成功/失败统计
  • 🚀 高性能 - 智能并发生成,多图同时处理,大幅提升生成速度
  • 🛡️ 稳定可靠 - 完善的错误处理,自动重试机制,确保生成成功率
  • 💰 价格实惠 - 多种模型选择(含 nano-banana-pro / nano-banana-pro-vt),价格低至¥0.02/次

💰 模型价格

我们支持 7 种主流AI图像生成模型,价格透明,按次计费:

模型名称价格(人民币)价格(美元)特点
GPT Image / 1.5¥0.02$0.0027上下文理解,综合能力强,支持中文理解
Flux Pro 1.1¥0.03$0.0041专业级质量
Flux Pro 1.1 Ultra¥0.04$0.0054超高质量
Flux Kontext Pro¥0.035$0.0047上下文理解强
Flux Kontext Max¥0.07$0.0095上下文理解强,支持中文理解
Nano Banana Pro / Pro VT参考官网-支持 imageSize(1K/2K/4K)

注:价格可能根据官网实时调整,以GrsAI官网为准


📦 安装方法 (第一次重启安装完成后,关闭ComfyUI,填写 .env 文件中的api-key。再重启一遍 ComfyUI 即可运行)

方法一:通过 ComfyUI Manager 安装(推荐)

  1. 在 ComfyUI 界面中打开 ComfyUI Manager
  2. 点击 "Install via Git URL"
  3. 输入:https://github.com/31702160136/ComfyUI-GrsAI.git
  4. 第一次重启安装完成后,关闭ComfyUI,填写 .env 文件中的api-key。再重启一遍 ComfyUI 即可运行。

如果安装报错:This action is not allowed with this security level configuration. 请参考以下教程

步骤 1:定位配置文件

根据 ComfyUI-Manager 版本,配置文件路径不同,下面是不同版本的文件位置

Manager 3.0 版本以上教程

当你的 ComfyUI Manger 在 3.0 版本以上时,请查找下面位置的文件 ComfyUI/user/default/ComfyUI-Manager/config.ini

Manager 3.0 版本以下教程

如果你的 ComfyUI Manger 在 3.0 版本以下,请查找下面位置的文件 ComfyUI/custom_nodes/ComfyUI-Manager/config.ini

步骤 2:修改安全参数

用文本编辑器打开 config.ini,找到:

security_level = normal

将其修改为:

security_level = weak

步骤 3:

重启服务

ComfyUI 桌面版: 完全退出 ComfyUI 后重新启动

ComfyUI Portable 版: 关闭后点击 run_nvidia_gpu.bat 重新启动

方法二:手动安装

方式A:通过 Git 克隆(推荐)

# 进入 ComfyUI 的 custom_nodes 目录
cd ComfyUI/custom_nodes/

# 克隆项目
git clone https://github.com/31702160136/ComfyUI-GrsAI.git
cd ComfyUI-GrsAI

# 安装依赖
pip install -r requirements.txt

方式B:下载 ZIP 文件

  1. 访问 项目页面
  2. 点击绿色 "Code" 按钮 → "Download ZIP"
  3. 解压到 ComfyUI/custom_nodes/ 目录
  4. 重要: 将解压后的文件夹从 ComfyUI-GrsAI-main 重命名为 ComfyUI-GrsAI
# 安装依赖
cd ComfyUI/custom_nodes/ComfyUI-GrsAI
pip install -r requirements.txt

便携版用户特别说明

便携版用户需要使用ComfyUI自带的Python环境安装依赖:

Git 克隆方式:

# 在 ComfyUI 根目录执行 例如:PS E:\ComfyUI_windows_portable_nvidia\ComfyUI_windows_portable>
 .\python_embeded\python.exe -m pip install --force-reinstall -r .\ComfyUI\custom_nodes\ComfyUI-GrsAI\requirements.txt

ZIP 下载方式:

# ⚠️ 注意:如果是下载ZIP解压,文件夹名称为 ComfyUI-GrsAI-main
# 请先重命名文件夹,或使用以下命令:
 .\python_embeded\python.exe -m pip install --force-reinstall -r .\ComfyUI\custom_nodes\ComfyUI-GrsAI-main\requirements.txt

# 重命名后推荐使用:
 .\python_embeded\python.exe -m pip install --force-reinstall -r .\ComfyUI\custom_nodes\ComfyUI-GrsAI\requirements.txt

🔑 API密钥设置

获取 API 密钥

您只需要获取 一个 API 密钥:

  • GrsAI密钥: 访问 GrsAI官网 登录后在控制台获取

配置方法

插件已经包含了 .env 配置模板文件,您只需要:

  1. 打开配置文件: ComfyUI/custom_nodes/ComfyUI-GrsAI/.env
  2. 替换 API 密钥: 将 sk-xxxxx 替换为您的真实密钥
GRSAI_API_KEY=your_grsai_api_key_here

配置位置: ComfyUI/custom_nodes/ComfyUI-GrsAI/.env

配置完成

保存文件后重启 ComfyUI 即可使用!



📋 系统要求

  • Python >= 3.8
  • ComfyUI (最新版本)
  • 依赖包:
    • requests
    • python-dotenv
    • httpx
    • httpcore

🐛 故障排除

节点相关问题

节点没有出现?

  • 完全重启 ComfyUI
  • 检查插件安装路径:ComfyUI/custom_nodes/ComfyUI-GrsAI
  • 确认依赖安装成功:pip list | grep httpx

节点显示红色错误?

  • 检查 .env 文件是否存在
  • 验证 API 密钥格式:GRSAI_API_KEY=your_key_here
  • 重启 ComfyUI

API 相关问题

生成失败?

  • 检查GrsAI账户余额
  • 查看节点状态信息获取详细错误

🔮 更新日志

v1.0.8

  • 🆕 新增 gpt-image-1.5 模型支持,提供更多 GPT Image 生成选项
  • 🔧 GPT Image 节点现已支持模型选择(sora-image / gpt-image-1.5
  • 🐛 修复了图生图节点第 6 张参考图无法正确上传的 bug

v1.0.7

  • 🌟 新增 nano-banana-pro-vt 模型支持(与 nano-banana-pro 相同能力)

v1.0.5

  • 🆕 Nano Banana 节点新增「使用宽高比」开关,未勾选时不会传递 aspectRatio
  • 📐 新增 Nano Banana 宽高比列表,覆盖 auto 与 10 种常用比例
  • 🧪 更新测试脚本:自动对齐生成分辨率到 32 像素网格,方便与 API 输出比对

v1.0.3

  • 🍌 新增 Nano Banana 模型支持:提供文生图、图生图与多图参考工作流

v1.0.0

  • 全新发布 - 四种生成模式完整支持
  • 🔑 简化配置 - 仅需一个 API 密钥
  • 批量优化 - 智能批处理和并发生成
  • 🌟 用户体验 - 中文界面,友好反馈
  • 🛡️ 稳定性 - 完善错误处理和重试机制
  • 💰 多模型支持 - 6种模型,价格从¥0.02起

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。


🤝 贡献与支持

贡献代码

欢迎提交 Issue 和 Pull Request!

  1. Fork 本项目
  2. 创建功能分支
  3. 提交代码更改
  4. 发起 Pull Request

获取支持

  • 项目文档: GitHub 仓库
  • 问题反馈: GitHub Issues
  • GrsAI官网: grsai.com
  • API文档: grsai.com

🔗 相关链接


⭐ 如果这个项目对您有帮助,请给我们一个星标!您的支持是我们持续改进的动力!