开发与 API
服务器概述
将 ComfyUI 作为服务器运行，通过 REST 和 WebSocket API 编程交互
ComfyUI 默认作为 HTTP 服务器在本地运行。你可以通过编程方式调用它来提交工作流、上传文件、下载输出和监控进度 — 无需打开浏览器。
启动服务器
启动 ComfyUI 时会自动启动 HTTP 服务器，地址为 http://127.0.0.1:8188。
以无界面模式运行（不打开浏览器）：
# 不打开浏览器运行
python main.py --disable-auto-launch# 指定自定义端口
python main.py --port 8288# 监听所有网络接口（用于远程访问）
python main.py --listen 0.0.0.0本部分的关键页面
启动参数
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 路由处理。参见路由机制。
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。