Comfy Cloud

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

Comfy Cloud 是 ComfyUI 的有状态、可交互、完全托管版本。你可以像在本地安装中一样，在浏览器里构建和运行工作流，而模型、GPU 以及其间的一切都由 Comfy 管理。你也可以通过 API 调用 Comfy Cloud。Comfy Cloud 提供托管端点，因此无需构建环境，也无需创建部署。

与 Comfy API 部署 不同（后者提供的是你构建并发布的一个固定环境），Comfy Cloud 提供的是始终在线的、完整托管的 ComfyUI。

如果你是 Comfy Cloud 的新用户，请参阅 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 格式导出工作流

   在云端编辑器中构建并测试工作流，然后通过 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、Comfy API 部署和自托管部署之间切换，请参阅 运行工作流。

​

积分与用量

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

​

并行执行（并发任务）

API 用户可以同时提交多个工作流，无需等待上一个任务完成。提交后，任务一经接受即返回，因此你可以同时保持多个任务在运行。调度器会并行执行这些任务，直至达到你订阅套餐的并发上限；请访问 platform.comfy.org 查看你当前的并发数。

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

并行执行目前仅可通过 API 使用。订阅详情请查看 定价页面。

​

现有的 v1 集成

弃用的 v1 Cloud API 同样运行在 Comfy Cloud 上。请仅将其用于现有集成，或用于 Comfy API v2 尚未开放的那些云端能力。可运行的示例位于 Cloud API Reference（已弃用）。