在 ComfyUI 的原生生态中,内置的 API 节点存在一个鲜为人知却至关重要的设计:它们并不直接调用供应商的 API。
无论你使用的是 OpenAI、Stability AI 还是 Google,所有请求默认都会被路由到 api.comfy.org——一个由官方运营的代理服务器。在这个架构下,Comfy.org 引入了一套模糊的“积分体系”来替代供应商原本的定价机制。
这就是所谓的“API 洗钱”(API Money Laundering)。
你向 Comfy.org 支付溢价购买积分,Comfy.org 再用这些积分去调用供应商接口,从中赚取差价。而你,作为最终用户,失去了对成本的控制、对数据的掌控,甚至可能面临合规风险。
- GitHub:https://github.com/holo-q/comfy-api-liberation
ComfyUI API Liberation 扩展应运而生。它的目标只有一个:彻底移除中间商。 让你的调用直达目标,使用你自己的密钥,享受供应商的原生费率,并确保数据隐私。
什么是“API 洗钱”?
“API 洗钱”是指代理服务在第三方 API 之上封装一层,用自有的积分体系取代原始供应商的定价和认证机制。用户从未与实际供应商建立直接连接,而是从中间商处购买专有积分,由中间商代为执行真实的 API 调用并从中获利。
在这种模式下:
- 用户:支付了更高的费用,却失去了透明度。
- 中间商:无需提供额外价值,仅靠流量分发赚取差价。
- 供应商:实际收到的费用可能被压缩,且面临服务条款被违反的风险。
为什么这很危险?
- 价格黑箱:中间商可以任意设定积分价格,无需跟随供应商的降价或促销。你无法判断自己是否在被“收割”。
- 合规风险:许多 API 提供商(如 OpenAI)明确禁止未经授权的转售或代理行为。使用此类服务可能导致你的账号被封禁,或使企业面临法律纠纷。
- 数据隐私泄露:你的提示词(Prompt)、生成的图像及敏感数据,必须经过一个本无权查看的第三方服务器。供应商的隐私保护承诺在此失效。
- 人为制造的单点故障:软件本身完全具备直连能力,代理的存在纯粹是为了制造计费瓶颈。一旦中间商宕机、涨价或跑路,你的工作流将立即瘫痪。
- 监管隐患:随着全球对数据经纪和 API 转售的监管日益严格,这种灰色地带的商业模式随时可能面临法律清算,最终波及无辜用户。
API 洗钱不是“提供服务”,而是“榨取价值”。 真正的服务应当创造价值,而不是剥夺用户使用自己 API 密钥的权利。
核心功能:把控制权还给你
ComfyUI API Liberation 通过技术手段“拨乱反正”,还原了 ComfyUI 应有的开放性与透明度。
- 🚀 直接 API 路由:拦截原本发往
api.comfy.org的请求,重写 URL,直接将调用发送至供应商原生端点。 - 🔑 无需账户绑定:彻底摆脱对 ComfyUI/Comfy.org 账户的依赖,无需注册,无需登录。
- 💾 本地资产存储:图像、视频等生成内容直接保存在本地,不再上传至任何中间服务器。
- 🌐 支持 20+ 主流供应商:涵盖 Google (Gemini/Veo), OpenAI (Sora/DALL-E), Stability AI, Flux, Runway, Kling, Luma 等几乎所有主流 AI 模型。
- 🎨 简洁 UI 配置:直接在 ComfyUI 界面内管理密钥,状态一目了然。
- 🔄 优雅降级:若未配置密钥,插件自动回退至 ComfyUI 默认行为,不影响原有工作流。
安装与配置:三步直达
第一步:安装插件
在 ComfyUI 的 custom_nodes 目录下克隆仓库:
cd ComfyUI/custom_nodes
git clone https://github.com/holo-q/comfy-api-liberation.git
安装完成后,重启 ComfyUI。
第二步:配置 API 密钥(三种方式)
插件支持灵活的密钥管理,优先级为:环境变量 > 配置文件 > UI 设置。
方式 1:通过 UI 配置(推荐)
- 点击 ComfyUI 工具栏中的 API Keys 按钮。
- 在弹出的面板中,为所需供应商输入密钥。
- 面板提供 Get Key 链接,一键跳转至供应商官网获取密钥。
- Status 列会实时显示“Configured”(绿色)或“Not Set”。
- 密钥将加密保存至本地的
api_keys.json文件中。

方式 2:环境变量
在启动 ComfyUI 前,在终端设置环境变量:
export GOOGLE_API_KEY="your-key-here"
export OPENAI_API_KEY="your-key-here"
export STABILITY_API_KEY="your-key-here"
# ...其他供应商

方式 3:手动配置文件
在插件目录下创建 api_keys.json 文件:
{
"google": "your-google-key",
"openai": "your-openai-key",
"stability": "your-stability-key"
}
第三步:无缝运行
配置完成后,无需修改任何现有工作流。
插件会在后台自动拦截并重写请求。原有的 API 节点将继续正常工作,但流量已悄然切换至直连模式。
安全保障:数据只属于你
在隐私和安全方面,ComfyUI API Liberation 坚持“零信任”原则:
- 本地存储:API 密钥仅保存在你本地的
api_keys.json文件中(该文件已默认加入.gitignore,防止误传)。 - 零上传:密钥永远不会发送到 ComfyUI 官方服务器或任何第三方。
- 点对点传输:你的数据直接在“你的机器”与“供应商服务器”之间传输,中间没有任何代理截获。
- 隔离认证:每个供应商仅能接收到属于它自己的 API 密钥,杜绝交叉泄露。















