如果你是 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
3
以 API 格式导出工作流
在云端编辑器中构建并测试工作流,然后通过
File → Export Workflow (API) 将其保存为 workflow_api.json。请参阅 工作流 API 格式。4
运行它
"9" 是你的工作流文件中输出节点的 ID。有关输入、进度事件和错误处理的信息,请参阅 SDK 指南。积分与用量
API 请求与 Comfy Cloud 网页界面共用同一份月度积分额度。不存在单独的 API 积分池。各档位包含的积分、充值选项以及每个工作流的运行时长上限,对 API 任务与 UI 任务完全同样适用。各档位的月度积分额度请参阅定价页面。如果月中积分已用完,可以从你的账户仪表盘购买充值。并行执行(并发任务)
API 用户可以同时提交多个工作流,无需等待上一个任务完成。提交后,任务一经接受即返回,因此你可以同时保持多个任务在运行。调度器会并行执行这些任务,直至达到你订阅套餐的并发上限;请访问 platform.comfy.org 查看你当前的并发数。 超出并发上限提交的任务会正常排队,并在槽位空出时自动执行。如果队列本身已满,SDK 会在有限的重试预算内自动为你重试,之后才抛出QueueFull。
并行执行目前仅可通过 API 使用。订阅详情请查看 定价页面。