v2가 실행되는 위치
동일한 API가 세 가지 진입점을 통해 제공되므로, 하나의 통합 코드는 기본 URL만 변경하면 그 사이를 이동할 수 있습니다. Comfy Cloud.https://cloud.comfy.org에서 제공되는 관리형 멀티 테넌트 서비스입니다. API 키를 생성하면 모든 워크플로를 제출할 수 있습니다. 크레딧, 모델 탐색, 실행 대기열 관리와 같은 클라우드 전용 기능은 v2가 아닌 v1 Cloud API에 있습니다.
Serverless API(Developer Platform). Developer Platform을 통해 배포하는 워크플로는 https://{deployment}.run.comfy.app에 자체 전용 엔드포인트를 가지며, 동일한 API 키를 사용하여 동일한 v2 API를 제공합니다. 서버리스 배포는 하나의 고정된 워크플로를 실행하므로 독립적으로 확장되며 GET /workflow는 실행된 그래프를 반환합니다. 빌드 및 배포에 대한 자세한 내용은 Serverless API 가이드를 참조하세요.
오픈소스 ComfyUI(프록시 경유). 베타 기간 동안 자체 호스팅 ComfyUI는 comfy-api-proxy를 통해 v2를 사용합니다. 이 프록시는 ComfyUI와 함께 실행되는 작은 오픈소스 서비스입니다:
127.0.0.1:8188의 ComfyUI를 프록시하고 127.0.0.1:8189에서 v2 API를 제공하며, 루프백에만 바인딩됩니다. 인증은 기본적으로 비활성화되어 있으며, 선택적으로 정적 베어러 토큰을 사용할 수 있습니다. 이 프록시는 임시 방편입니다. v2가 안정화되면 ComfyUI 코어에 통합되며 프록시는 더 이상 필요하지 않습니다. 구성 세부 정보는 SDK 가이드의 자체 ComfyUI를 참조하세요.
설계 원칙
- 폴링 우선. 모든 기능은 일반 GET 폴링을 통해 접근할 수 있습니다. SSE 스트림은 실시간 개선 사항일 뿐, 결코 진실의 원천이 아닙니다.
- 모든 것은 재개 가능. 제출은 멱등적이며, 작업 상태와 출력은
expires_at까지 ID로 조회할 수 있습니다. - 콘텐츠 주소 지정 에셋. 에셋은 서버가 계산한 blake3 해시를 키로 하는 blob을 UUID로 식별하는 레코드이므로, 동일한 입력이 두 번 업로드되지 않습니다.
- 링크를 따라가고, URL을 직접 만들지 마세요. 응답에는 후속 URL이 포함되어 있습니다.