API Nodes
在本篇中我们将介绍 ComfyUI 关于 API Nodes 的相关说明。
API Nodes 是 ComfyUI 新增的调用闭源模型的方式,通过 API 调用,这将为 ComfyUI 用户提供访问外部最先进 AI 模型的能力,而无需复杂的 API 密钥设置。
什么是 API Nodes?
API Nodes 是一组特殊的节点,它们能够连接到外部 API 服务,让您直接在 ComfyUI 工作流中使用闭源或第三方托管的 AI 模型。这些节点设计用于无缝集成外部模型的功能,同时保持 ComfyUI 核心的开源特性。
目前支持的模型包括:
- Black Forest Labs: Flux 1.1[pro] Ultra, Flux .1[pro], Flux .1 Kontext Pro, Flux .1 Kontext Max
- Google: Veo2, Gemini 2.5 Pro, Gemini 2.5 Flash
- Ideogram: V3, V2, V1
- Kling: 2.0, 1.6, 1.5 & Various Effects
- Luma: Photon, Ray2, Ray1.6
- MiniMax: Text-to-Video, Image-to-Video
- OpenAI: o1, o1-pro, o3, gpt-4o, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, DALL·E 2, DALL·E 3, GPT-Image-1
- PixVerse: V4 & Effects
- Pika: 2.2
- Recraft: V3, V2 & Various Tools
- Rodin: 3D Generation
- Stability AI: Stable Image Ultra, Stable Diffusion 3.5 Large, Image Upscale
- Tripo: v1-4, v2.0, v2.5
使用 API Nodes 的前提要求
要使用 API Nodes 节点,需要有以下节点要求
1. ComfyUI 版本要求
请更新你的 ComfyUI 到最新版本,由于我们后期可能会新增更多的 API 支持, 相应的节点也会进行更新, 所以请保持你的 ComfyUI 处于最新版本。
请注意需要区分 nightly 版本和 release 版本,我们推荐使用 nightly
版本(也就是最新的代码 commit 提交),因为 release 版本可能不会及时更新。
也就是对应的开发版本和稳定版本,由于我们仍在快速地迭代中,此文档并不一定及时更新,所以请注意对应的版本差异。
2. 账号及账户余额要求
需要当前已经在 ComfyUI 中登录了 Comfy账号,并且账户积分大于 0
在 设置
-> 用户
中进行登录:
并在 设置
-> 积分
中购买积分:
请参考对应的账号及积分部分的文档来确保这一要求:
3. 网络环境要求
- 本地网络仅允许
127.0.0.1
或者localhost
访问可以直接使用登录功能 - 如果是局域网或者非白名单网站访问请使用 API Key 登录,请参考使用 API Key 进行登录
- 能够正常访问我们的 API 服务(在某些地区可能需要使用代理服务)
- 要求在
https
环境下访问,保证请求的安全性
不安全的上下文访问会有巨大的风险可能会有以下后果:
- 身份认证被窃取,从而造成你的账号信息泄露
- 账号被恶意使用,造成经济损失
就算是后期我们开放了这一限制,我们依然强烈建议你不要通过不安全的网络请求访问 API 服务,因为这一风险极大.
4. 使用对应节点
添加到工作流:将 API 节点添加到您的工作流中,就像使用其他节点一样 运行:设置好参数后运行工作流
使用 API Key 在非白名单网站登录 ComfyUI 账户来使用 API Nodes
目前我们设置有白名单来限制可以登录ComfyUI 账户的网站,如果需要在一些非白名单网站登录 ComfyUI 账户,请参考账号管理相关的部分了解如何使用 API Key 来进行登录,在这种情况下不需要对应的网站在我们的白名单中。
账户管理
查看如何使用 ComfyUI API Key 登录
使用 ComfyUI API Key 集成来调用付费模型 API 节点
目前我们支持通过 ComfyUI API Key 集成来访问我们的服务来调用付费模型 API 节点,请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费模型 API 节点
API Key 集成
请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费模型 API 节点
API Nodes 的优势
API Nodes 为 ComfyUI 用户提供了几个重要优势:
- 访问闭源模型:使用最先进的 AI 模型,无需自行部署
- 无缝集成:API 节点与其他 ComfyUI 节点完全兼容,可以组合创建复杂工作流
- 简化的体验:无需管理 API 密钥或处理复杂的 API 请求
- 可控的成本:预付费系统确保您完全控制支出,没有意外费用
计费方式
API 节点计费
请参考定价页面了解对应的 API 定价
关于开源和选择加入
重要的是要注意,API Nodes 是完全可选的。ComfyUI 将始终保持完全开源,并对本地用户免费。API 节点设计为”选择加入”功能,为那些想要访问外部 SOTA(最先进)模型的用户提供便利。
如何使用 API Nodes
API Nodes 的一个强大应用是将外部模型的输出与本地节点结合。例如:
- 使用 GPT-Image-1 生成基础图像,然后通过本地
WanImageToVideo
节点转换为视频 - 结合外部生成的图像与本地的上采样或风格转换节点
- 创建混合工作流,充分利用闭源和开源模型的优势
这种灵活性使 ComfyUI 成为真正的通用生成式 AI 入口,将各种不同的 AI 功能整合到一个统一的工作流中,带来了更多可能性
常见问题
为什么我找不到 API 节点?
为什么我找不到 API 节点?
请更新你的 ComfyUI 到最新版本(最新的 commit,或者最新的桌面版),由于我们后期可能会新增更多的 API 支持, 相应的节点也会进行更新, 所以请保持你的 ComfyUI 处于最新版本。
请注意需要区分 nightly 版本和 release 版本,有些情况下 nightly
版本(也就是最新的代码 commit 提交)才会包含最新的节点,因为 release 版本可能不会及时更新。
由于我们仍在快速地迭代中,所以当你无法找到对应节点时请确保你使用的是最新的版本。
为什么我无法使用 / 登录 API Nodes 节点?
为什么我无法使用 / 登录 API Nodes 节点?
API 访问需要你当前的请求是基于安全的网络环境,目前对 API 访问的网络环境要求如下:
- 本地网络仅允许
127.0.0.1
或者localhost
访问, 这可能意味着,你无法在局域网环境下使用带有--listen
参数启动的 ComfyUI 服务中中使用 API Nodes 节点 - 能够正常访问我们的 API 服务(在某些地区可能需要使用代理服务)
- 你的账号没有足够的积分
为什么登录了还是无法使用或在使用时还会继续要求我登录?
为什么登录了还是无法使用或在使用时还会继续要求我登录?
- 目前仅支持
127.0.0.1
或者localhost
访问, - 确保你的账户有足够余额
API Nodes 节点可以免费使用吗?
API Nodes 节点可以免费使用吗?
API Nodes 节点由于需要通过 API 调用闭源模型,所以需要使用积分,不支持免费使用
要如何购买积分?
要如何购买积分?
未用完的积分支持退款吗?
未用完的积分支持退款吗?
目前我们不支持对积分进行退款。 如果你觉得是因为技术问题出现了错误而存在未使用的余额,请联系支持
积分可以出现负数吗?
积分可以出现负数吗?
不允许积分出现负数,所以在对应 API 调用前,请确保你有足够的积分。
我可以在哪里查看使用量和花费?
我可以在哪里查看使用量和花费?
请在登录后访问积分 菜单,查看相应的积分。
支持使用自己的 API Key 吗?
支持使用自己的 API Key 吗?
目前 API Nodes 节点仍在测试阶段,目前暂不支持,我们已经把这个功能纳入考虑中了。。
积分会过期吗?
积分会过期吗?
不你的积分不会过期。
积分可以转让或者共享吗?
积分可以转让或者共享吗?
不,你的积分不能转让给其他用户,也只限制于当前登录账户使用,但是我们并不限制登录设备的数量
我可以在不同设备间使用同一个账户吗?
我可以在不同设备间使用同一个账户吗?
我们不限制登录的设备数量,你可以在你想要的任何地方使用你的账号?
我该如何请求删除我的账户或信息?
我该如何请求删除我的账户或信息?
请发送请求邮件至 support@comfy.org,我们将删除您的信息。