把 ComfyUI 接入自己的应用：优先划清服务接口，不直接塞进 main.py

这是应用集成问题，不是“装错 Python”

某些讨论围绕 main.py 难以嵌入其他程序。本文将它归入开发集成，而不是与便携包缺模块合并。ComfyUI 官方服务文档列出了提交任务、查询历史、获取文件及 WebSocket 等路由。1

我们建议的首版边界

让 ComfyUI 作为独立进程运行，你的业务应用负责提交、跟踪与展示。固定服务地址、记录任务 ID、保存请求与结果之间的关系；不要把导入一个入口脚本当作已经获得稳定的库接口。

只读连通性检查可以先访问自己控制的本地服务：

curl --fail http://127.0.0.1:8188/system_stats

若实例不在本机，地址必须明确配置，不能假设浏览器所在设备就是服务端。该请求成功只说明一个路由可访问，不意味着任务提交、授权或文件读取都已验收。

接口层应怎样处理失败

在业务侧区分连接失败、请求校验失败、任务执行失败和结果下载失败。重试策略按阶段设置；提交请求超时时，先确认是否已经创建任务，避免重复生成。不要让外部用户任意指定服务器读取的本地路径。

部署与验收

不要为图方便直接把未加保护的执行服务暴露到公网。为上层入口设计身份与访问控制，做小任务的完整闭环，再检查断线重连、超时及取消行为。本文是建议架构，不是已发布的 ComfyUI 嵌入式 SDK。

相关排查

• Failed to fetch 不一定是 ComfyUI 崩了：先找到失败的请求
• 工作流保存失败：先保住画布，再查保存请求

已按来源逐篇复核的编辑建议；本站未进行本机/GPU 执行，也不保证存在稳定的嵌入式 Python SDK。全站审核门槛完成前继续禁止收录。