Comfy API v2 概览

用于从外部应用运行 ComfyUI 工作流的官方版本化 HTTP API：上传输入、提交工作流、观察执行、获取结果。 大多数人应该从 Comfy SDK 开始，这些 SDK 使用 Python 和 TypeScript 封装了此 API。如果您使用其他语言，可以直接调用这些端点。

​

设计原则

• 优先轮询。 每项能力都可以通过简单的 GET 轮询访问。SSE 流是实时增强，绝不是事实来源。
• 一切皆可恢复。 提交是幂等的，在 expires_at 之前，任务状态和输出均可通过 ID 检索。
• 内容寻址资产。 资产是基于内容寻址 blob 的 UUID 标识记录，blob 以服务器计算的 blake3 哈希为键，因此相同的输入不会被重复上传。
• 跟随链接，不要自行构造 URL。 响应中嵌入了后续 URL。

想了解这些设计背后的原因，请参阅 设计说明。

​

基础 URL

​

端点分类

​

Comfy Router

Comfy API v2 通过提交并轮询的持久任务来运行工作流。如需直接调用模型（单个合作伙伴模型、单个请求、模型的原生输入和输出），请参阅 Comfy Router。请先阅读 Router 限制。Router 目前尚未正式推出。