ComfyUI-CometAPI

ComfyUI-CometAPI

作者：B 站「那颗星星188」

ComfyUI-CometAPI 是一套面向 ComfyUI 的多模态 API 创作节点插件。

它不是单纯把 API 接口塞进 ComfyUI，而是把图像、视频、音乐、文本、批量任务、素材卡片、局部运行、设置中心和内置对话助手整合到一套更适合 API 创作的工作流里。

授权提醒：本项目采用自定义非商业授权协议。个人学习、高校科研、非营利组织可免费使用；企业、公司内部业务、商业项目、付费服务、二次销售、客户交付等商业用途，必须先联系作者购买商业授权。详见 LICENSE。

主要解决什么问题

在 ComfyUI 里接 API 做图像、视频、音乐创作时，经常会遇到：

• 多参考图连线混乱。
• 生成结果复用时容易重跑上游。
• 不同模型参数差异大，容易传错参数。
• 批量生成缺少稳定的编号、失败处理和输出管理。
• LLM、图像、视频、音乐之间衔接不够顺。
• 提示词和素材管理不够画布化。

CometAPI 的目标是让这些流程更干净、更可控，也更适合长期迭代。

核心功能

• 统一节点：提供 Comet 图像、视频、音乐、文本、批量图像等节点。
• 设置中心：统一配置渠道、API Key、模型、别名、自定义模型和提示词预设。
• 动态参数：根据渠道和模型自动显示适合的比例、分辨率、时长、模式等参数。
• 虚拟连线：多参考图可以拖到统一素材入口，减少画布连线混乱。
• 素材卡片：图像、视频、音频、文本结果可以保存成卡片，后续复用不必重复跑上游。
• 单点运行：支持只运行局部节点，减少整张工作流重跑。
• 批量图像：支持多提示词、多参考图、文件夹批量、并发、失败策略和独立输出目录。
• 异步任务：支持图片和视频的异步提交与收取，适合长耗时任务。
• 提示词组织：支持文本卡片、批量文本卡片、@ 素材引用和 / 提示词预设。
• 内置对话：可以在 ComfyUI 内直接打开 AI 对话窗口，用于问报错、写提示词、看代码、发附件和对话生图。

节点列表

• Comet 图像
• Comet 批量图像
• Comet 异步图像提交
• Comet 异步图片收取
• Comet 文本
• Comet 视频
• Comet 异步视频提交
• Comet 异步视频收取
• Comet 音乐
• Comet 图像卡片
• Comet 视频卡片
• Comet 音频卡片
• Comet 文本卡片
• Comet 批量文本卡片
• Comet 文本追加
• CometAPI 设置中心

安装方式

进入 ComfyUI 的 custom_nodes 目录：

cd ComfyUI/custom_nodes
git clone https://github.com/jieg9341-lab/ComfyUI-CometAPI.git

然后重启 ComfyUI。

如果缺少网络请求相关依赖，可以在 ComfyUI 的 Python 环境中安装：

python -m pip install requests aiohttp

基本使用

1. 安装插件并重启 ComfyUI。
2. 在节点列表中搜索 Comet。
3. 打开 CometAPI 设置中心，配置 API 渠道、API Key 和模型。
4. 添加需要的节点，例如 Comet 图像、Comet 视频、Comet 文本。
5. 选择渠道、模型和参数。
6. 连接节点并运行工作流。

私有渠道

插件支持通过 private_channels 目录扩展私有渠道。

公开分发版不会内置具体私有渠道业务逻辑，只保留识别、加载和适配机制。

如需编写私有渠道，请阅读：

private_channels/私有渠道适配指南.md

注意：

• 不要把 API Key 写进私有渠道文件。
• API Key 应在插件设置页填写。
• 不要把客户私有渠道逻辑提交到公开仓库。

输出和本地数据

生成的图片、视频、音频等资源会保存到 ComfyUI 输出目录下，例如：

ComfyUI/output/cometapi_assets
ComfyUI/output/comet_chat

用户配置和对话数据会保存在本地，请勿提交到公开仓库。

授权协议

本项目采用自定义非商业授权协议。

• 个人学习：免费。
• 高校科研：免费。
• 非营利组织：免费。
• 企业使用：需要商业授权。
• 公司内部业务：需要商业授权。
• 商业项目或付费服务：需要商业授权。
• 二次销售、打包销售、客户交付：需要商业授权。

详细条款见 LICENSE。

商业授权请通过 B 站「那颗星星188」或 GitHub Issues 联系作者。