워크플로 실행하기

라이브 배포에서 ComfyUI 워크플로를 실행하는 방법과 어떤 클라이언트가 어떤 배포에서 작동하는지

ComfyUI가 어딘가에 배포되면, 애플리케이션은 해당 ComfyUI를 대상으로 워크플로를 실행합니다: 워크플로를 제출하고, 실행을 기다린 다음, 출력을 다운로드합니다. 이 페이지에서는 어떤 배포 환경에 어떤 클라이언트를 사용해야 하는지 설명합니다.

여기서 시작하세요: Comfy SDK

새로운 통합을 구축할 때는 공식 Comfy SDK(Python 및 TypeScript)와 SDK가 호출하는 Comfy API v2를 사용하세요. 동일한 코드가 모든 배포 대상에서 실행되며, 기본 URL만 변경하면 됩니다.

Comfy SDKs

SDK를 설치하고, 워크플로를 제출하고, 출력을 다운로드하세요. 현재 베타 버전입니다.

무엇이 무엇과 호환되나요

배포	Comfy SDKs / API v2	참고 사항
Serverless API 배포	예	API 키를 사용해 COMFY_BASE_URL을 https://<deployment>.run.comfy.app으로 설정하세요
Comfy Cloud	예	기본 베이스 URL입니다. API 키와 유료 구독이 필요합니다
자체 호스팅	예, API 프록시를 통해	v2 베타 기간에는 ComfyUI와 함께 실행되는 작은 서비스가 v2 API를 제공합니다

자체 호스팅 인스턴스는 SDK를 완전히 건너뛰고 ComfyUI Server API(REST + WebSocket)를 직접 사용할 수도 있습니다. 이 API는 실행 대기열과 노드 정보를 포함한 로컬의 모든 기능을 노출하지만, 릴리스 간 호환성은 보장되지 않습니다.

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

	Comfy API v2 + SDKs	v1 Cloud API	ComfyUI Server API
실행 위치	서버리스 배포, Comfy Cloud 또는 API 프록시를 통한 자체 호스팅	Comfy Cloud 전용	자체 호스팅 전용
호환성	버전 관리됨, v2 내에서 추가 변경만 허용	지원 중단됨, 사전 공지 없이 변경될 수 있음	릴리스 간 보장 없음
인증	클라우드 및 서버리스에서 Authorization: Bearer. 자체 호스팅: 기본적으로 없음, 선택적 정적 베어러 토큰	X-API-Key 헤더(Comfy Cloud 계정)	없음(로컬) 또는 파트너 노드용 API 키
공식 클라이언트	Python 및 TypeScript SDK	없음, HTTP로 호출	없음, HTTP로 호출
프로토콜	REST + SSE	REST + WebSocket	REST + WebSocket
범위	워크플로 실행 및 결과 얻기	모델 및 계정을 포함한 Cloud의 전체 기능	실행 대기열 및 노드 정보를 포함한 로컬의 전체 기능
적합한 용도	지속적으로 작동해야 하는 새로운 통합	기존 통합 및 v2가 아직 다루지 않는 Cloud 기능	완전한 제어, 자체 인스턴스를 위한 맞춤형 도구

세 API 모두 동일한 워크플로 형식(API 형식)을 지원하므로 워크플로를 로컬에서 개발하고 테스트한 후 변경 없이 다른 배포 환경으로 이동할 수 있습니다.

시작하기

Comfy SDKs

Python 또는 TypeScript에서 모든 배포 대상에 대해 워크플로를 실행합니다.

셀프 호스팅용 API 프록시

직접 운영하는 ComfyUI 앞에서 v2 API를 제공하여 SDK가 접근할 수 있게 합니다.

워크플로 API 형식

API가 허용하는 JSON 형식으로 워크플로를 내보냅니다.

ComfyUI 서버 API

셀프 호스팅 인스턴스의 원시 REST 및 WebSocket API입니다.

전제 조건

• Comfy Cloud, Serverless 배포 또는 파트너 노드를 사용하는 모든 작업에는 API 키가 필요합니다. 로컬 전용 ComfyUI에는 필요하지 않습니다.
• API 형식으로 내보낸 워크플로.