SaladTechnologies/comfyui-api

解决的问题

ComfyUI 是一个强大的生成式 AI 节点化界面，但主要设计为交互式工具。本项目为 ComfyUI 提供了一个无状态 API 封装，使其更容易集成到需要水平扩展、异步处理和自动模型管理的生产环境中。

工作原理

服务器作为位于 ComfyUI 前端的代理。它通过 HTTP 请求接收 API 格式的提示图，处理所需输入媒体的下载，通过 ComfyUI 的内部 API 执行工作流，然后交付生成的图像。支持同步响应（直接返回 base64 图像）和异步响应（将结果发送到 Webhook 或云存储）。

适用人群

希望将 ComfyUI 工作流作为可扩展微服务部署的开发者和工程师，特别是使用 Kubernetes 或 SaladCloud 等容器化环境的用户。

主要亮点

• 无状态架构：设计为可在负载均衡器后进行水平扩展。
• 灵活的输出交付：支持以 base64 形式返回图像、上传至 S3 兼容存储、Azure Blob 存储，或通过 Webhook 发送。
• 自动模型管理：支持从 URL 动态加载模型、启动时下载的清单系统，以及按需模型下载端点。
• 广泛模型支持：已验证支持 Stable Diffusion（1.5、XL、3.5）、Flux、AnimateDiff，以及 LTX、Hunyuan、CogVideoX、Mochi 等多种视频模型。
• 可自定义端点：通过向服务器添加脚本文件，可创建动态工作流端点。