SaladTechnologies/comfyui-api

해결하는 문제

ComfyUI는 생성형 AI를 위한 강력한 노드 기반 인터페이스이지만, 주로 상호작용 도구로 설계되었습니다. 이 프로젝트는 ComfyUI에 상태 없는 API 래퍼를 제공하여 수평 확장, 비동기 처리, 자동 모델 관리가 필요한 프로덕션 환경에 쉽게 통합할 수 있도록 합니다.

작동 방식

서버는 ComfyUI 앞에 위치하는 프록시 역할을 합니다. HTTP 요청을 통해 API 형식의 프롬프트 그래프를 수신하고, 필요한 입력 미디어를 다운로드한 후 ComfyUI의 내부 API를 통해 워크플로우를 실행한 뒤 결과 이미지를 전달합니다. 동기 응답(직접 base64 이미지 반환)과 비동기 응답(웹훅 또는 클라우드 스토리지로 결과 전송)을 모두 지원합니다.

대상 사용자

Kubernetes나 SaladCloud와 같은 컨테이너 환경을 사용하며 ComfyUI 워크플로우를 확장 가능한 마이크로서비스로 배포하고자 하는 개발자 및 엔지니어.

주요 특징

• 상태 없는 아키텍처: 로드 밸런서 뒤에서 수평 확장이 가능하도록 설계되었습니다.
• 유연한 출력 전달: base64 이미지로 반환하거나, S3 호환 스토리지, Azure Blob Storage에 업로드하거나 웹훅을 통해 전송할 수 있습니다.
• 자동 모델 관리: URL에서 동적 모델 로딩, 시작 시 다운로드를 위한 매니페스트 시스템, 온디맨드 모델 다운로드 엔드포인트를 지원합니다.
• 광범위한 모델 지원: Stable Diffusion(1.5, XL, 3.5), Flux, AnimateDiff, LTX, Hunyuan, CogVideoX, Mochi 등 다양한 비디오 모델을 포함해 검증되었습니다.
• 사용자 정의 가능한 엔드포인트: 서버에 스크립트 파일을 추가하여 동적 워크플로우 엔드포인트를 생성할 수 있습니다.