启动服务器
启动 ComfyUI 时会自动启动 HTTP 服务器,地址为http://127.0.0.1:8188。
以无界面模式运行(不打开浏览器):
本部分的关键页面
启动参数
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 路由处理。参见路由机制。