Comfy Cloud

使用 Comfy Cloud 作为始终可用的托管部署，通过 API 运行工作流

Comfy Cloud 是有状态、交互式且完全托管的 ComfyUI 版本。您可以像在本地安装中一样，在浏览器中构建和运行工作流，而 Comfy 负责管理模型、GPU 以及介于两者之间的一切。您还可以直接通过 API 调用它，将 Comfy Cloud 用作无服务器 API 端点：无需构建环境，也无需创建部署。

您可以将其视为一种永久性的无服务器部署。Serverless API 部署服务于一个由您构建并发布的固定环境，而 Comfy Cloud 提供的则是一个完整、托管且始终在线的 ComfyUI。

如果您是初次接触，请参阅 Comfy Cloud 简介。本节介绍如何以开发者身份使用 Comfy Cloud API。

快速入门

Comfy Cloud 开箱即用地支持 Comfy SDK：基础 URL 默认指向 Comfy Cloud，因此你只需要一个 API 密钥 和一个工作流。API 访问需要付费的 Comfy Cloud 订阅；免费版不包含此功能。

1. 创建 API 密钥

   在 platform.comfy.org 登录并创建一个密钥。分步说明请参阅获取 API 密钥。

2. 安装 SDK

   Python

   pip install comfy-sdk
   
3. 以 API 格式导出工作流

   在 Cloud 编辑器中构建并测试工作流，然后使用 File → Export Workflow (API) 将其保存为 workflow_api.json。请参阅工作流 API 格式。

4. 运行

   Python

   from comfy_sdk import Comfy
   
   client = Comfy(api_key="comfyui-...")  # Comfy Cloud is the default target
   
   wf = client.workflows.from_file("workflow_api.json")
   
   job = client.run(wf)
   for output in job.get_outputs("9"):
       output.to_file(output.name)
   

   "9" 是工作流文件中输出节点的 ID。有关输入、进度事件和错误处理的说明，请参阅 SDK 指南。

有关相同代码如何在 Comfy Cloud、Serverless 和自托管部署之间迁移的说明，请参阅运行工作流。

积分与使用

API 请求与 Comfy Cloud 网页界面共用同一月度积分配额。没有单独的 API 积分池。各套餐包含的积分、充值选项以及每工作流的运行时长上限，对 API 任务和界面任务完全同样适用。各套餐的月度积分数量请参阅定价页面。如果月中积分已用完，可从账户仪表盘购买充值。

并行执行（并发任务）

API 用户可以并发提交多个工作流，无需等待上一个任务完成。任务被接受后，提交立即返回，因此你可以让多个任务同时进行中。调度器会在你的订阅层级限制内并行运行这些任务；请查看 platform.comfy.org 了解你当前的并发数。

超出并发限制提交的任务会正常排队，并在有空闲名额时自动执行。如果队列本身已满，SDK 会在有限的预算内为你重试，然后才抛出 QueueFull。

并行执行目前仅通过 API 提供。订阅详情请参见定价页面。

现有的 v1 集成

弃用的 v1 Cloud API 也运行在 Comfy Cloud 上。仅将其用于现有集成，或用于 Comfy API v2 尚未提供的云端功能。可运行示例见 Cloud API 参考（已弃用）。