ComfyUI-nkxx

ComfyUI-nkxx (那颗星星 API 节点包)

这是一个专为 ComfyUI 打造的综合性 AI 节点插件包，深度接入了 Grsai 和 无极 AI (Wujiai) 双渠道的强大模型生态。无论是顶级的图像生成、高质量的视频生成，还是大语言模型的图文理解与提示词生成，都能在 ComfyUI 中一站式、高效率地完成！

🌟 作者与获取 API

• 作者 B站：那颗星星188 （欢迎关注，获取最新教程与工作流更新！）
• Grsai 渠道 API 申请：nkxx.grsai.ai
• 无极 AI (Wujiai) 渠道 API 申请：点击这里注册获取

---

🛠️ 安装指南

1. 安装节点包

将本节点包（ComfyUI-nkxx 文件夹）直接放置于你的 ComfyUI 自定义节点目录下：

ComfyUI/custom_nodes/ComfyUI-nkxx

(注：首次重启 ComfyUI 时，节点包会自动检测并安装所需的 Python 依赖库，如 requests, pandas, yt-dlp 等。如果自动安装失败，请手动在环境中 pip install 相关库。)

2. 导入内置工作流

本节点包内置了作者精心调教的配套工作流。请将节点包内 workflows 目录下的所有内容，复制到 ComfyUI 的默认用户工作流文件夹中：

ComfyUI/user/default/workflows/

复制完成后，刷新 ComfyUI 网页，即可在右侧面板的 Load 或工作流列表中直接调用“那颗星星工作流_grsai”和“那颗星星工作流_wujiai”系列。

---

✨ 核心功能模块

🚀 无极 AI 渠道 (Wujiai)

• 通用生图引擎 (Universal Generator)：一个节点打通 Gemini、Nano Banana、Grok、GPT、Seedream 等多种模型。支持单图同步、异步生成，以及强大的 CSV/Excel 批量处理和本地文件夹批量生成。
• Midjourney 无极版：完美复刻 MJ 的生图体验。支持垫图、风格参考(--sref)、角色参考(--cref)，并独家支持前端按钮交互（U/V/Reroll 动作直接在节点面板上点击刷新）。自带四宫格自动切分功能。
• 顶尖视频生成：
  • Sora2：支持图生视频、文生视频、批量异步提交。
  • Veo 3.1：支持首尾帧控制、多参考图、4K 分辨率生成。
  • Grok Video：支持 Grok-video-3 及 10s/15s 长视频生成。

🍌 Grsai 渠道

• Nano Banana 图像引擎：支持nanobanana 1、2与 Pro 模型（最高支持 4K 分辨率），最多可同时传入 14 张参考图。支持单图、批量表单（CSV/Excel）、命名细化版导出。
• Sora2 视频与角色定制：支持视频生成，以及强大的“角色上传”与“原视频提取角色”功能，并将角色 ID 自动归档至本地数据库。
• GPT Image (Sora-Image)：支持 OpenAI 最新图像模型，兼容流式数据处理。
• Veo 3.1 视频：同步/异步生成，全面支持首尾帧和多重垫图控制。
• VLM/LLM 视觉与语言助手：接入 Gemini 2.5 / 3.1 系列大模型。可进行纯文本对话、多图视觉分析，非常适合用于自动化生成 Midjourney/生图提示词并保存为 CSV。

🧰 专属增强工具箱 (Tools)

• 🔑 API Key 管理器：可视化全局管理 API Key，支持多组 Key 切换，原生 UI 深度美化。
• 🕹️ 快速运行中控台 (GroupRunner)：读取工作流中的所有 Group，一键单独运行指定 Group 内的节点，极大提升巨型工作流的调试效率。
• 🖼️ 图像动态列表：可根据数字自由增减图像输入端口，实现动态合并。
• ☁️ 模型云端热更新：节点内置模型列表云端同步，随时获取最新模型支持，无需频繁更新插件代码。

---

🛡️ 核心优势与技术亮点

1. 安全熔断保护 (Circuit Breaker)
   • 内置智能请求频率检测。如果用户开启了 ComfyUI 的“Auto Queue(自动排队)”导致极短时间内重复提交相同提示词，系统将自动触发熔断拦截，防止您的 API 积分或额度被意外耗尽。
2. 企业级异步任务管理
   • 底层采用线程安全（Thread-Lock）的 TaskManager，将所有异步任务自动保存在本地 data/ 目录的 JSON 数据库中。不怕断电、不怕重启，随时可以查询进度并下载结果。
3. 多线程与防爆下载
   • 视频下载器自带 yt-dlp 和 curl 双重回退机制，确保在大文件或网络波动环境下的极高下载成功率。
4. 无缝的批量自动化
   • 深度支持读取 .csv, .xls, .xlsx 文件进行批量跑图/跑视频。
   • 支持扫描整个本地文件夹的图像，结合 CSV 提示词进行并发批量图生图，自动处理并保存到指定目录。