API 개요

ComfyUI와 프로그래밍 방식으로 상호작용하는 다양한 방법에 대한 개요

ComfyUI는 워크플로를 어디에서 실행하고 인프라를 얼마나 관리할지에 따라 여러 API 옵션을 제공합니다. 이 페이지는 올바른 접근 방식을 선택하는 데 도움이 됩니다.

---

​

여기서 시작

새로운 통합을 위해서는 Comfy SDKs와 SDK가 호출하는 Comfy API v2를 사용하세요. v2는 새로운 버전 관리 HTTP 인터페이스이며, 기존의 Cloud API 및 ComfyUI Server API와 함께 존재합니다. Comfy API v2 개요를 참조하세요. 동일한 코드가 Comfy Cloud와 자신의 머신에서 모두 실행됩니다.

Comfy SDKs

자체 애플리케이션에서 워크플로를 실행하기 위한 공식 Python 및 TypeScript SDK입니다. 현재 베타 버전입니다.

아래의 다른 API는 여전히 완전히 지원되며, SDK가 아직 다루지 못하는 영역을 다룹니다. 여기에 있는 어떤 것도 지원 중단되지 않습니다.

​

어떤 API를 사용해야 하나요?

	Comfy API v2 + SDKs	Cloud API	ComfyUI Server API
실행 위치	Comfy Cloud 또는 로컬 프록시를 통한 자체 머신	Comfy Cloud(관리형 GPU)	자체 머신
호환성	버전이 지정되며 v2 내에서는 추가적인 변경만 이루어짐	실험적이며 예고 없이 변경될 수 있음	릴리스 간 호환성 보장 없음
GPU 관리	연결하는 대상에 따라 다름	자동으로 처리됨	하드웨어를 직접 관리
모델	연결하는 대상에 따라 다름	Comfy에서 사전 설치 및 관리	직접 다운로드하여 로컬에서 관리
인증	Cloud에서는 Authorization: Bearer. 자체 호스팅은 기본적으로 없음, 선택적 정적 Bearer 토큰	X-API-Key 헤더(Comfy Cloud 계정)	없음(로컬) 또는 파트너 노드용 API 키
기본 URL	https://cloud.comfy.org 또는 http://127.0.0.1:8189	https://cloud.comfy.org	자체 서버 URL(예: http://localhost:8188)
공식 클라이언트	Python 및 TypeScript SDK	없음, HTTP로 호출	없음, HTTP로 호출
프로토콜	REST + SSE	REST + WebSocket	REST + WebSocket
범위	워크플로 실행 및 결과 획득	모델 및 계정을 포함한 전체 Cloud 기능	실행 대기열 및 노드 정보를 포함한 전체 로컬 기능
적합한 경우	계속 작동해야 하는 새로운 통합	SDK가 아직 지원하지 않는 Cloud 기능	전체 제어, 사용자 지정 하드웨어 및 모델

모두 동일한 워크플로 형식(API 형식)을 사용하므로, 워크플로를 로컬에서 개발하고 테스트한 다음 변경 없이 클라우드로 이동할 수 있습니다.

​

시작하기

Comfy SDK

Python 또는 TypeScript에서 클라우드 또는 자체 머신을 대상으로 워크플로를 실행하세요.

클라우드 API

Comfy의 관리형 인프라에서 워크플로를 실행하세요. GPU 설정이 필요 없습니다.

ComfyUI 서버 API

자체 머신에서 ComfyUI를 서버로 실행하고 API를 통해 호출하세요.

파트너 노드 API 연동

헤드리스 또는 API 기반 워크플로에서 유료 파트너 노드를 사용하세요.

---

​

사전 준비 사항

API를 사용하기 전에 다음이 필요합니다:

• Comfy Cloud 또는 파트너 노드와 관련된 모든 작업에는 API 키가 필요합니다(API 키 받기 참조). 완전히 로컬에서 실행되는 ComfyUI는 API 키가 필요하지 않습니다.