ComfyUI, 멀티모달 생성 모델 통합 라우팅 API 'Comfy Router' 출시
ComfyUI가 이미지, 비디오, 3D, 오디오 프론티어 모델을 단일 엔드포인트로 연동하는 Comfy Router를 출시했습니다. 동일한 파라미터로 Fal, Runware 등 복수 프로바이더를 전환 호출합니다.
ComfyUI 공식 개발팀이 2026년 9월 23일(현지 시각), 최첨단 이미지·비디오·3D·오디오 생성 모델을 단일 API 엔드포인트로 연동하는 'Comfy Router'를 정식 출시했습니다. Comfy 개발자 플랫폼(Comfy Developer Platform)을 통해 제공되는 이번 서비스는 파운데이션 미디어 생성 모델을 자체 호스팅 인프라 구축 없이도 즉시 제품과 파이프라인에 통합할 수 있도록 지원합니다.
이미지 출처: ComfyUI (@ComfyUI) / X
단일 인터페이스와 프로바이더 명시적 라우팅 아키텍처
Comfy Router의 핵심은 이미지, 비디오, 3D 에셋, 오디오 등 서로 다른 모달리티의 생성형 AI 모델을 하나의 일관된 인터페이스로 추상화한 점입니다. 기존에는 Fal, Runware, WaveSpeed, Higgsfield 등 프로바이더마다 SDK 구조와 인증 방식, 작업 수명 주기가 상이하여 멀티 프로바이더 파이프라인을 구축할 때마다 상당한 엔지니어링 비용이 소모되었습니다.
Comfy Router 환경에서는 동일한 모델 식별자 문자열과 인자(Arguments) 규격을 그대로 유지하면서 호출 파라미터의 프로바이더 값만 변경하여 백엔드 실행 위치를 전환할 수 있습니다. 예를 들어 특정 모델이 여러 플랫폼에서 지원될 경우, 코드나 인프라 재배포 없이 provider 파라미터 한 줄만 수정하여 장애 대응이나 가격 최적화를 달성할 수 있습니다.
특히 주목할 점은 묵시적 폴백(Silent fallback)이나 임의의 경로 변경을 완전히 배제한 '명시적 라우팅(Explicit routing)' 정책입니다. 개발자가 특정 프로바이더를 지정하여 호출했을 때 해당 공급자 측 서버 장애나 일시적 중단이 발생하면, 시스템이 임의로 다른 프로바이더로 우회하지 않고 즉시 해당 공급자의 에러를 반환합니다. 또한 모든 작업 반환값에 실제 작업을 처리한 프로바이더 정보가 명시되어 투명한 로깅, 정밀한 디버깅, 정확한 사용량 과금 추적이 가능합니다.
비동기 큐잉과 대규모 배치 작업 처리 체계
장시간의 연산이 요구되는 생성형 미디어 파이프라인의 특성을 고려하여, Comfy Router는 고도화된 비동기 작업 수명 주기를 기본으로 제공합니다.
클라이언트가 비동기 작업 생성 메서드인 submit()을 호출하면 즉각적으로 고유 요청 ID(Request ID)가 반환됩니다. 라우터 내부 큐 시스템은 호출 과정에서 발생할 수 있는 HTTP 429 속도 제한(Rate Limit)이나 일시적인 네트워크 오류를 감지하여 유효한 작업 슬롯이 확보될 때까지 자동으로 재시도를 수행합니다. 따라서 클라이언트 측에서 번거로운 지수 백오프나 재시도 데몬을 직접 구현할 필요가 줄어듭니다.
동기식 대기가 필요한 시나리오를 위해 제출과 폴링을 한 번에 처리하는 subscribe() 메서드도 함께 제공됩니다. 수 분 이상 소요되는 고해상도 비디오 렌더링이나 수백 건 이상의 대규모 배치(Batch) 이미지를 일괄 생성할 때도, 요청 ID를 보관한 채 시스템 블로킹 없이 순차적으로 생성 완료 에셋을 수집할 수 있습니다.
단, 데이터 보존 정책에 따른 주의가 필요합니다. Comfy Router에 전송된 입력 프롬프트와 파라미터, 생성된 출력 미디어 파일은 시스템 내부에서 24시간 동안만 유지된 후 자동으로 영구 삭제됩니다. 따라서 서비스 파이프라인에서 지속적인 보관이 필요한 미디어 에셋은 생성 완료 즉시 자체 오브젝트 스토리지나 외부 영구 저장소로 이전하는 다운로드 로직을 구성해야 합니다.
개발자 SDK 지원과 통합 크레딧 과금 정책
ComfyUI 팀은 개발자가 신규 파이프라인을 손쉽게 구축할 수 있도록 공식 REST 엔드포인트와 전용 SDK 생태계를 함께 공개했습니다.
공식 엔드포인트(POST https://api.comfy.org/v2/models/{provider}/{model})를 통한 HTTP 직접 통신 외에도, 공식 Python SDK(pip install comfy-sdk)와 TypeScript SDK(@comfyorg/sdk)가 함께 배포되었습니다. 클라이언트 초기화 후 모델 식별자와 프롬프트 인자, 대상 프로바이더를 전달하는 간결한 인터페이스로 복잡한 생성 워크플로우를 즉시 제어할 수 있습니다.
과금 정책 역시 개발자 친화적으로 설계되었습니다. 월간 기본 구독료나 별도의 라우터 중개 수수료가 일체 없으며, 단일 Comfy 크레딧 계정을 통해 호출한 모델의 실제 소비량만큼만 통합 정산됩니다. 별도의 프로바이더 계정이나 개별 API 키를 복잡하게 관리할 필요 없이 하나의 통합 키로 파운데이션 모델 호출과 향후 Comfy API 워크플로우 배포를 모두 아우를 수 있습니다.
도입 시 고려해야 할 기술적 제약 사항도 명확합니다. Comfy Router는 개발자가 전송하는 입력 스키마에 대해서는 유효성 검증을 엄격하게 수행하지만, 각 업스트림 프로바이더가 반환하는 응답 결과에 대해서는 스키마 구조를 강제하지 않습니다. 따라서 클라이언트 애플리케이션 레벨에서 반환된 미디어 타입, 응답 필드, 예외 상황에 대한 수신 데이터 검증 절차를 반드시 수반해야 합니다.