接入教程

中转接入教程

按工具查看接入步骤和排查方法。

首页/中转接入教程/ComfyUI 配置

ComfyUI 配置

ComfyUI 是图片和视频工作流工具。它不是普通聊天工具，核心不是“选一个模型聊天”，而是加载一个工作流，再把提示词、图片、参数填进工作流节点里。

官方信息 下载和文档以官方站点为准
官方网站 了解 ComfyUI 下载入口 Comfy Desktop 和安装入口 官方文档 工作流、安装和 API 说明

先理解工作流

一个 ComfyUI 工作流通常包含模型加载、提示词、采样器、尺寸、输出保存等节点。你在网页里看到的线和节点，就是生成图片或视频的步骤。

如果你要通过 API 调用 ComfyUI，通常需要把工作流导出成 API 格式的 JSON，再发送到本地或云端的 ComfyUI 服务。

工作流界面参考 先理解节点、连线和 Run 按钮，再看 API 调用。ComfyUI 的重点不是 Key，而是工作流是否能跑通。
ComfyUI 官方文档中的工作流界面截图

本地地址怎么填

配置项填写方式
网页地址http://127.0.0.1:8188
API 地址http://127.0.0.1:8188/prompt
工作流workflow-api.json
输出History / Output 文件夹
  1. 先启动 ComfyUI，确认浏览器能打开 http://127.0.0.1:8188。
  2. 在 ComfyUI 里加载一个已经能成功出图的工作流。
  3. 开启开发者或 API 导出选项，把工作流保存成 API JSON。
  4. 用脚本或接口把这个 JSON 发送到 /prompt。
  5. 生成后从历史记录或输出文件夹里查看图片。

API 调用示例

把工作流发给本地 ComfyUI
curl -X POST http://127.0.0.1:8188/prompt \ -H "Content-Type: application/json" \ -d @workflow-api.json
图片/视频工作流的报错大多来自模型文件缺失、节点版本不一致、显存不足，不要只检查 Key 和 Base URL。

新手常见问题

现象优先检查处理
网页能打开但 API 失败请求地址是否是 /prompt，工作流是否导出为 API 格式先在网页里跑通，再重新导出 API JSON
提示缺少节点工作流使用了你本机没有安装的自定义节点按工作流说明安装节点，或换一个基础工作流测试
提示模型文件不存在checkpoint、LoRA、VAE 等文件路径把模型文件放到 ComfyUI 对应目录，重启后再选
显存不足图片尺寸、批量数量、模型大小先降低尺寸和批量，确认能出图后再提高参数