comfyui_grsai

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

🚀 概述

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

📸 功能演示

🎨 文生图模式

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

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

🖼️ 图生图模式

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

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

🎭 多图融合模式

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

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

✨ 核心特性

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

---

🍌 Nano Banana 支持

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

• 节点名称: 🍌 GrsAI Nano Banana - Text/Image
• 模型选项: nano-banana、nano-banana-fast、nano-banana-pro、nano-banana-pro-vt、nano-banana-pro-vip、nano-banana-pro-4k-vip、nano-banana-pro-cl
• 输入方式:
  • 仅填写 prompt 为文生图
  • 连接 1–6 张参考图像端口为图生图/多图融合
• 输出: image（生成图像）与 status（状态文本）
• 可选参数:
  • 通过 使用宽高比 勾选框决定是否传入 aspectRatio
  • 宽高比列表支持 auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9

使用步骤（ComfyUI 内）：

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

🔥 项目优势

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

---

🎬 Sora2 视频生成支持

全新支持 OpenAI Sora2 视频生成模型，提供强大的文生视频和图生视频能力：

• 节点分类: GrsAI/Sora2

节点1：视频生成

• 节点名称: 🎬 GrsAI Sora2 - Video Generation
• 模型: sora-2
• 输入方式:
  • 仅填写 prompt 为文生图
  • 连接 image 或填写 url 为图生视频
• 输出: video（生成视频）、video_url（视频URL）、pid（项目ID）、response（API响应）
• 可选参数:
  • aspect_ratio: 宽高比，支持 16:9、9:16
  • duration: 视频时长，支持 10、15 秒
  • size: 视频尺寸，支持 small、large
  • remix_target_id: 混音目标ID
  • characters: 角色列表

节点2：角色上传

• 节点名称: 🎭 GrsAI Sora2 - Character Upload
• 功能: 上传视频并提取角色
• 输入:
  • video_url: 视频URL
  • timestamps: 时间戳字符串，例如 0,3

节点3：角色创建

• 节点名称: 🎭 GrsAI Sora2 - Character Creation
• 功能: 使用PID和时间戳创建角色ID
• 输入:
  • pid: 项目ID（从视频生成任务中获取）
  • timestamps: 时间戳字符串，例如 0,3

---

🎬 Veo 视频生成支持

全新支持 Google Veo 视频生成模型，提供高效的文生视频能力：

• 节点分类: GrsAI/Veo

节点1：纯文本视频生成

• 节点名称: 🎬 GrsAI Veo - Text to Video
• 模型选项: veo3.1-fast、veo3.1-pro
• 输入方式:
  • prompt: 视频描述提示词（必填）
• 输出: video（生成视频）、video_url（视频URL）、pid（项目ID）、response（API响应）
• 可选参数:
  • aspect_ratio: 宽高比，支持 16:9、9:16

使用步骤（ComfyUI 内）：

1. 搜索并添加节点 🎬 GrsAI Veo - Text to Video
2. 填写提示词 prompt
3. 选择 model 和 aspect_ratio
4. 运行并查看输出视频

节点2：首尾帧视频生成

• 节点名称: 🎬 GrsAI Veo - First/Last Frame
• 模型选项: veo3.1-fast、veo3.1-pro
• 输入方式:
  • prompt: 视频描述提示词
  • first_frame: 第一帧图片（必填）
  • last_frame: 最后一帧图片（可选）
• 输出: video（生成视频）、video_url（视频URL）、pid（项目ID）、response（API响应）
• 可选参数:
  • aspect_ratio: 宽高比，支持 16:9、9:16

使用步骤（ComfyUI 内）：

1. 搜索并添加节点 🎬 GrsAI Veo - First/Last Frame
2. 填写提示词 prompt
3. 连接 first_frame 输入第一帧图片
4. 可选：连接 last_frame 输入最后一帧图片
5. 选择 model 和 aspect_ratio
6. 运行并查看输出视频

节点3：参考图视频生成

• 节点名称: 🎬 GrsAI Veo - Reference Images
• 模型选项: veo3.1-fast、veo3.1-pro
• 输入方式:
  • prompt: 视频描述提示词
  • image1: 参考图1（必填）
  • image2: 参考图2（可选）
  • image3: 参考图3（可选）
• 输出: video（生成视频）、video_url（视频URL）、pid（项目ID）、response（API响应）
• 可选参数:
  • aspect_ratio: 宽高比，支持 16:9、9:16

使用步骤（ComfyUI 内）：

1. 搜索并添加节点 🎬 GrsAI Veo - Reference Images
2. 填写提示词 prompt
3. 连接 image1 输入至少一张参考图片
4. 可选：连接 image2、image3 输入更多参考图
5. 选择 model 和 aspect_ratio
6. 运行并查看输出视频

---

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

手动安装

方式A：通过 Git 克隆（推荐）

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

# 克隆项目
git clone https://github.com/lusyoe/comfyui_grsai
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.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

---

🔗 相关链接

• GrsAI官网: grsai.com
• ComfyUI: github.com/comfyanonymous/ComfyUI
• Flux模型: Black Forest Labs
• GPT模型: openai

---

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