Skip to main content
베타: Comfy API v2는 0.1.x 버전이며 API 표면은 여전히 변경될 수 있습니다. v2 내 변경 사항은 추가적으로 제공됩니다. 호환성을 깨뜨리는 변경은 v3로 출시됩니다.
외부 애플리케이션에서 ComfyUI 워크플로를 실행하기 위한 공식 버전 관리 HTTP API입니다: 입력 업로드, 워크플로 제출, 실행 관찰, 결과 검색. 대부분의 사용자는 이 API를 Python과 TypeScript로 래핑한 Comfy SDKs부터 시작해야 합니다. 다른 언어로 작업하는 경우 이러한 엔드포인트를 직접 호출하세요. 전체 엔드포인트 문서는 OpenAPI 사양에서 생성된 이 섹션의 API Reference 페이지에 있습니다.

​
v2 실행 환경

동일한 API를 세 가지 환경에서 제공하므로, 기본 URL만 변경하면 하나의 통합을 이들 사이에서 옮길 수 있습니다. Comfy Cloud. https://cloud.comfy.org의 관리형 멀티 테넌트 서비스입니다. API 키를 만들면 어떤 워크플로든 제출할 수 있습니다. 크레딧, 모델 탐색, 대기열 관리 같은 Cloud 전용 기능은 v2가 아니라 v1 Cloud API에 있습니다. Comfy API 배포. Developer Platform을 통해 배포한 환경은 https://{deployment}.run.comfy.app에 자체 전용 엔드포인트를 가지며, 동일한 API 키로 같은 v2 API를 제공합니다. Comfy API 배포는 하나의 고정된 환경에서 워크플로를 실행하므로 독립적으로 확장되며, GET /workflow는 실행된 그래프를 반환합니다. 빌드와 배포 방법은 Comfy API 배포 가이드를 참조하세요. 오픈소스 ComfyUI, 프록시 경유. 베타 기간 동안 자체 호스팅 ComfyUI는 함께 실행되는 작은 오픈소스 서비스인 comfy-api-proxy를 통해 v2를 지원합니다:
기본적으로 127.0.0.1:8188의 ComfyUI를 프록시하고 127.0.0.1:8189에서 v2 API를 제공하며, 루프백에만 바인딩합니다. 인증은 기본적으로 꺼져 있고 선택적으로 정적 Bearer 토큰을 사용할 수 있습니다. 이 프록시는 임시 방편입니다. v2가 안정화되면 ComfyUI 코어로 이동하므로 프록시는 더 이상 필요하지 않습니다. 구성 세부 정보는 SDK 가이드의 자체 ComfyUI 실행을 참조하세요.

​
설계 원칙

  • 폴링 우선. 모든 기능은 일반 GET 폴링으로 접근할 수 있습니다. SSE 스트림은 실시간 개선 사항일 뿐, 결코 진실의 원천은 아닙니다.
  • 모든 것은 재개 가능합니다. 제출은 멱등적이며, 작업 상태와 출력은 expires_at까지 ID로 검색할 수 있습니다.
  • 콘텐츠 주소 지정 에셋. 에셋은 서버에서 계산된 blake3 해시를 키로 하는 blob에 대한 UUID 식별 레코드입니다. 따라서 동일한 입력이 두 번 업로드되지 않습니다.
  • 링크를 따르고 URL을 직접 만들지 마세요. 응답에는 후속 URL이 포함되어 있습니다.
이러한 설계 원칙에 대한 근거는 디자인 노트를 참조하세요.

​
기본 URL

​
엔드포인트 카테고리

​
Comfy Router

Comfy API v2는 제출 후 폴링하는 영속적인 작업(job)으로 워크플로를 실행합니다. 모델을 직접 호출해야 하는 경우(파트너 모델 하나, 요청 하나, 모델 고유의 네이티브 입력 및 출력)에는 Comfy Router를 참조하세요. 먼저 Router 제한 사항을 검토하세요. Router는 아직 일반 공개되지 않았습니다.