账号系统是为了支持 API Nodes 节点而新增的，API Nodes支持了对闭源模型 API 的调用，这大大扩展了 ComfyUI 的可能性，由于对应的 API 调用需要消耗 Token，所以我们增加了对应的用户系统。

当前我们支持以下几种登录方式：

  • 邮箱登录
  • Google 登录
  • Github 登录
  • API Key 登录(非白名单网站授权使用)

登录要求相关及说明，我们在本篇文档中会进行对应说明

​
ComfyUI 版本要求

你可能至少需要使用 ComfyUI v0.3.0 版本才能使用账号系统,确保对应前端版本至少为1.17.11,有时候前端可能会安装失败而导致回滚到旧版本，所以请在设置 -> 关于 查看前端版本是否大于1.17.11

在部分地区可能会因为网络限制无法正常访问登录 API 导致登录超时或者失败， 在登录前请确保你的网络环境不会被限制对应 API 的访问，保证能够正常访问 Google 或者 Github 等网站。

由于我们仍在快速迭代更新，所以相关功能可能会有变动，如果没有特殊情况，请尽量更新到最新版本以获取相关功能支持。

​
网络要求

要使用API，你必须处于安全的网络环境中：

  • 允许从127.0.0.1或localhost访问。
  • 不支持使用--listen参数通过局域网访问API节点。
  • 在未启用 SSL 证书即非 https 开头的站点你可能无法成功登录
  • 你可能无法在不在我们白名单的站点中登录（可以通过 API Key 登录）
  • 确保你能够正常连接我们的服务（在某些地区可能需要代理来访问）。

​
如何进行登录

在 设置 -> 用户 中进行登录：

​
登录方式

如果是首次登录，请首先创建一个账户。

​
使用 API Key 进行登录

由于目前并非所有 ComfyUI 的相关部署都是在我们的域名授权白名单中，所以在通过非白名单的网站登录时，在近期（2025-05-10）的更新中我们提供了 API Key 登录，下面是使用 API Key 登录的相关步骤：

1

在登录界面选择 Comfy API Key 登录

在登录弹窗中选择 Comfy API Key 登录

2

输入你的 API Key

  1. 输入你的 API Key，并保存即可
  2. 如果你没有 API Key，点击 在这里获取 链接跳转到 https://platform.comfy.org/login 并登录获取。
3

登录成功

登录成功后你可以在设置菜单中看到对应的 API Key 登录信息

​
登录后状态

登录后在 CofmyUI 界面顶部菜单栏显示登录按钮，并可以通过该按钮打开对应的登录界面，并可以在设置菜单中退出对应的账号

​
常见问题