跳转到主要内容
ComfyUI 默认作为 HTTP 服务器在本地运行。你可以通过编程方式调用它来提交工作流、上传文件、下载输出和监控进度 — 无需打开浏览器。

启动服务器

启动 ComfyUI 时会自动启动 HTTP 服务器,地址为 http://127.0.0.1:8188 以无界面模式运行(不打开浏览器):
# 不打开浏览器运行
python main.py --disable-auto-launch
查看完整启动参数请运行 python main.py --help,或参阅启动参数参考

本部分的关键页面

启动参数

main.py 全部命令行启动参数完整参考。

API 路由

可用的 HTTP 端点:提交工作流、上传文件、查询状态。

API 示例

调用 API 的代码示例:仅 HTTP、WebSocket + History、SaveImageWebsocket。

服务器消息

执行过程中服务器发送给客户端的 WebSocket 消息类型。

执行模型反转

高级:反转执行以实现自定义控制流。

使用 Partner Nodes

如果工作流包含付费 Partner Nodes,可在请求体中包含 API Key。详见 Partner Node API 集成 指南。

服务器工作原理

Comfy 服务器构建于 aiohttp 框架 基础之上,该框架则依赖于 asyncio 库。 服务器向客户端发送消息时,会通过 send_sync 方法(server.py 中定义的 PromptServer 类实例)以 socket 消息形式发送。这些消息由 api.js 中注册的 socket 事件监听器处理。参见消息传递 客户端向服务器发送消息时,通过 api.js 中定义的 api.fetchApi() 方法,由服务器端设定的 HTTP 路由处理。参见路由机制
当请求加入队列时,客户端会提交完整的工作流(包括所有组件的当前值)。 一旦请求进入队列,服务器不会接收之后对工作流的任何修改。 若需在执行过程中动态调整服务器行为,需要使用路由机制。