ComfyPilotComfyPilot
文档 / 开发 / 自托管 ComfyUI 的 API 代理

自托管 ComfyUI 的 API 代理

在你自己的 ComfyUI 前面提供 Comfy API v2 服务,让官方 SDK 能够针对它运行工作流

开发 api-proxy 更新于 2026-10-10

查看官方原文

自托管 ComfyUI 的 API 代理

在你自己的 ComfyUI 前面提供 Comfy API v2 服务,让官方 SDK 能够针对它运行工作流

Comfy SDK 使用 Comfy API v2。自托管的 ComfyUI 通过 comfy-api-proxy 提供 v2 服务,这是一个与你的实例一起运行的小型开源服务。

安装并运行

pip install comfy-api-proxy
comfy-api-proxy

默认情况下,它会代理 127.0.0.1:8188 上的 ComfyUI,并在 127.0.0.1:8189 上提供 v2 API 服务。使用 --comfyui 和 --port 可更改任意一项。

如果你还想将模型文件上传到你的安装目录中,请使用 --comfyui-base-dir /path/to/ComfyUI 运行它。

让 SDK 指向它

设置基础 URL,并像往常一样构造客户端:

export COMFY_BASE_URL="http://127.0.0.1:8189"
from comfy_sdk import Comfy

client = Comfy()
import { Comfy } from "@comfyorg/sdk";

const client = new Comfy();

SDK 指南中的所有内容,针对代理与针对 Comfy Cloud 的使用方式完全相同。

身份验证

默认情况下不需要身份验证。如果代理配置了静态 bearer token,请将该 token 作为 SDK 的 API 密钥传入:Comfy(api_key="...")。

[!WARNING] 默认情况下,代理仅绑定到环回地址。如果你要将其暴露到环回之外,例如放在租用 GPU 上的 ComfyUI 前面,请配置 bearer token,或在其前面放置一个带身份验证的反向代理。

后续步骤