文档 /
开发 /
自托管 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,或在其前面放置一个带身份验证的反向代理。
后续步骤
- Comfy SDK:客户端指南
- Comfy API v2 参考:代理所提供的 HTTP 契约
- 自托管选项:在其后面运行 ComfyUI 的位置
- 设计说明:代理存在的原因