一个基于FastAPI的ComfyUI API封装中间件，提供RESTful API和Web调试界面。
- ✅ 完整的ComfyUI API封装 - 支持所有ComfyUI核心功能
- ✅ Web调试界面 - 美观的前端界面，支持工作流上传、参数调整、任务执行
- ✅ 实时状态更新 - WebSocket实时推送任务状态
- ✅ 工作流管理 - 支持工作流上传、保存、参数编辑
- ✅ 任务队列管理 - 查看队列状态，支持任务中断
- ✅ 历史记录 - 查看历史执行记录和结果
- ✅ 参数智能识别 - 自动识别工作流中的可编辑参数
pip install -r requirements.txt- 复制
.env.example为.env - 修改配置文件中的 ComfyUI 服务器地址
COMFYUI_COMFYUI_SERVER=192.168.48.123:8188python start.py或指定参数：
python start.py --host 0.0.0.0 --port 8000 --comfyui-server 192.168.48.123:8188- SuperVideo界面: http://localhost:8000 (视频放大功能)
- 监控面板: http://localhost:8000/dashboard (工作流调试工具)
- API文档: http://localhost:8000/docs
- 健康检查: http://localhost:8000/api/health
- API使用文档 - 完整的API使用指南，包括参数说明和多种语言示例
- Postman使用指南 - 如何使用Postman测试API，包含预配置的Collection
- 项目结构说明 - 详细的项目架构和目录结构说明
- 工作流适配指南 - 如何将ComfyUI工作流适配为专用API
访问 http://localhost:8000 使用SuperVideo视频放大功能，或访问 http://localhost:8000/dashboard 使用通用工作流调试工具。
-
导入Collection：
在Postman中导入 ComfyUI_API.postman_collection.json -
发送请求：
- 打开 "3. 提交工作流" 请求
- 修改Body中的提示词
- 点击 Send
- task_id会自动保存到环境变量
-
查询结果：
- 打开 "4. 查询任务状态" 请求
- 点击 Send（自动使用保存的task_id）
详细使用方法请查看 Postman使用指南
curl -X POST http://localhost:8000/api/workflow/submit \
-H "Content-Type: application/json" \
-d @workflows/your_workflow.json更多示例请查看 API使用文档
import requests
import json
# 读取工作流文件
with open('workflow.json', 'r') as f:
workflow = json.load(f)
# 提交任务
response = requests.post(
'http://localhost:8000/api/workflow/submit',
json={
'workflow': workflow,
'params': {
'6.text': '你的提示词', # 修改节点6的text参数
'3.seed': 12345, # 修改节点3的seed参数
},
'timeout': 600
}
)
task = response.json()
print(f"任务ID: {task['task_id']}")task_id = "your-task-id"
response = requests.get(f'http://localhost:8000/api/task/{task_id}')
status = response.json()
print(f"任务状态: {status['status']}")const ws = new WebSocket('ws://localhost:8000/ws');
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.type === 'task_update') {
console.log(`任务 ${data.task_id} 状态: ${data.status}`);
}
};GET /api/health- 健康检查GET /api/system/info- 系统信息GET /api/nodes- 获取所有节点信息GET /api/queue- 队列状态POST /api/queue/clear- 清空队列
POST /api/workflow/submit- 提交工作流POST /api/workflow/upload- 上传工作流文件GET /api/workflows- 列出所有工作流GET /api/workflow/{filename}- 获取工作流详情POST /api/workflow/update- 更新工作流参数
GET /api/task/{task_id}- 获取任务状态GET /api/tasks- 列出所有任务POST /api/interrupt/{prompt_id}- 中断任务GET /api/history- 获取历史记录
GET /api/image/{filename}- 获取生成的图片GET /api/video/{filename}- 获取生成的视频POST /api/upload/image- 上传图片到ComfyUI
POST /api/super_video/upload_and_upscale- 上传视频并放大（SuperVideo）POST /api/super_video/upscale- 使用已上传视频放大
├── main.py # FastAPI主应用入口
├── config.py # 配置管理
├── core/ # 核心代码模块
│ ├── comfyui_client.py # ComfyUI客户端封装
│ ├── managers.py # 任务和连接管理器
│ ├── models.py # 数据模型定义
│ ├── response.py # 统一响应格式
│ └── api/ # API路由模块
│ ├── system.py # 系统API
│ ├── task.py # 任务管理API
│ ├── media.py # 媒体文件API
│ ├── workflow.py # 通用工作流API
│ └── specialized/ # 专用工作流API
│ └── super_video.py # SuperVideo视频放大API
├── static/ # 静态文件（前端页面）
│ ├── index.html # 监控面板（工作流调试工具）
│ └── specialized/
│ └── super_video.html # SuperVideo视频放大界面
├── workflows/ # 工作流存储目录
├── uploads/ # 上传文件目录
└── outputs/ # 输出文件目录
详细结构说明请查看 项目结构文档
- 支持上传和编辑任意ComfyUI工作流
- 自动识别工作流中的可编辑参数
- 实时任务状态监控
- WebSocket实时推送任务更新
- AI视频超分辨率处理，支持4倍放大
- 支持多种放大模型（FlashVSR等）
- 自动保留原视频的帧率和音频
- 智能分块处理大视频
- 确保ComfyUI服务器正常运行并可访问
- 大型模型生成可能需要较长时间，请适当设置timeout
- WebSocket连接会自动重连，无需手动处理
- 支持同时运行多个任务（取决于ComfyUI服务器配置）
MIT