前言¶
在本地跑 ComfyUI 出图时,常见的两类问题是:一是你想让 Agent 帮忙提交一个工作流、轮询结果,但它并不认识 ComfyUI 的 HTTP API,得你自己复制 prompt ID 去查 history;二是你在局域网另一台机器上装了 ComfyUI,手动连一下还行,让 Agent 自动生成图片就断了,因为它不知道服务在哪、也不知道怎么连。
下面介绍的 ComfyUI Control,就是用来解决「Agent 与 ComfyUI 之间的连接和控制」这件事的。
这是什么¶
ComfyUI Control 是一个社区维护的 Skill,坐标 @user_86d3f55f/comfyui-control,发布者 user_86d3f55f,分类 ai-agent,当前版本 1.0.1,来源 community,标签 requires_api_key=false(即不需要 API key)。
它做的事一句话概括:连接并控制本机或局域网内的 ComfyUI,通过 ComfyUI HTTP API 提交任务、查看状态、出图。适用场景是用户想控制 localhost 或其他机器上的 ComfyUI、测试 ComfyUI URL、诊断连接失败、检查模型或节点、上传输入图片、校验 workflow JSON、提交 prompt、轮询 history,或自动化图像生成。
核心功能¶
根据资料,已核实的能力包括:
- 连接与检测:连接本机或局域网内的 ComfyUI,支持检测连接是否可用、诊断连接失败,也能用来测试 ComfyUI URL。
- 资源查看:查看当前 ComfyUI 加载了哪些模型和节点。
- 图片上传:上传输入图片作为图生图等流程的输入。
- 工作流校验:校验 workflow JSON 是否有效。
- 预设工作流:生成 FLUX 文生图、图生图、放大等工作流。
- 任务提交与出图:通过 ComfyUI HTTP API 提交任务并出图,支持轮询 history 获取结果。
- 无需 API key:
requires_api_key=false,不需要额外申请密钥。
这些能力都围绕 ComfyUI HTTP API 展开,本质是把「手动点 ComfyUI 界面」的操作,转换成 Agent 能执行的 API 调用。
安装与启用¶
关于安装方式:资料中未给出具体的安装命令或目录路径,因此本节不展开安装步骤。这类基于 SKILL.md 格式的 Skill,一般通过 SkillHub 平台获取后启用,但具体命令需以官方页面为准。
启用后,Agent 需要知道 ComfyUI 服务的地址。如果是本机,通常是 http://localhost:8188;如果是局域网另一台机器,地址由你环境的部署决定。Skill 本身不固定地址,需要你在使用时指定。
典型用法¶
资料中未提供逐条可复现的命令示例,下面给出基于其能力的使用思路,命令细节以 ComfyUI HTTP API 官方文档为准。
- 先确认服务可达:在能访问 ComfyUI 的机器上测试 URL,确认端口和服务正常,这一步用于排除「地址不对或服务没起」的问题。
- 检查模型与节点:服务连上后查看可用的模型和节点,确认目标工作流需要的模型已加载。
- 准备输入:如果是图生图,先上传输入图片;如果只是文生图,可跳过。
- 生成或校验工作流:用预设的 FLUX 文生图 / 图生图 / 放大工作流,或直接传入你自己的 workflow JSON 并校验。
- 提交任务:通过 ComfyUI HTTP API 的
/prompt接口提交工作流,拿到 prompt ID。 - 轮询结果:用 prompt ID 轮询 history,等待生成完成后取回图片。
上面每一步对应的是 ComfyUI 标准 HTTP 接口,Skill 的作用是让 Agent 能按这套流程自动跑通,而不用你手动操作界面。
适用场景与注意¶
适合的人:已经在本地或局域网部署 ComfyUI、希望让 Agent 自动提交工作流出图的开发者;需要批量生成、自动化图像生成流程的人;遇到连接问题需要定位是地址还是服务问题的场景。
需要注意的点:
- 服务地址要可达:本机用
localhost:8188,跨机器要用局域网地址,Agent 所在机器必须能访问到该地址,否则连接会失败。 - 不内置地址:Skill 不固定 ComfyUI 地址,地址由使用环境决定,跨机使用时要确认网络和端口放通。
- 工作流兼容性:预设工作流针对 FLUX,如果你用的是其它模型或自定义工作流,需自行校验 workflow JSON,节点缺失会导致提交失败。
- 安装命令未在资料中给出:本节的安装步骤未能从官方资料核实,启用前请以官方页面为准。
结尾¶
ComfyUI Control 的价值在于:把 ComfyUI 的连接、资源查看、任务提交和轮询这套流程封装成 Agent 可调用的能力,让「让 Agent 自动出图」这件事少一些手工操作。它不负责模型训练或工作流设计,只负责把已有的 ComfyUI 服务接起来、跑起来。
官方地址:https://api.skillhub.cn/user_86d3f55f/comfyui-control