Skip to main content
Comfy API는 관리형 자동 확장 GPU 엔드포인트에서 워크플로를 실행합니다. Build는 모델, 커스텀 노드, 설정을 포함한 ComfyUI 환경을 설명합니다. CLI는 Build로부터 릴리스를 생성하고 이를 엔드포인트로 배포합니다.

Comfy API 빠른 시작

에이전트로 시작하거나 환경 또는 워크플로를 제공하는 다른 방법을 선택하세요.
Desktop 스냅샷과 워크플로 JSON 가져오기에 대해서는 Build 소스를 참조하세요.

​
빌드 파일

comfy-build.yaml은 Build 정의와 마지막으로 확인된 원격 상태를 저장합니다. CLI는 이 상태를 사용해 원격 Build가 변경되었는지 감지합니다. 이 파일은 프로젝트와 함께 보관하세요. 환경을 설명하는 파일이며 모델 파일은 포함하지 않습니다. 변경 사항을 푸시하기 전에 로컬 Build가 설치된 내용 및 원격 버전과 어떻게 다른지 확인합니다:

​
업데이트 및 릴리스

로컬 설치를 변경한 뒤에는 Build 정의를 새로 고칩니다:
기존 Build에서 다른 릴리스를 만들려면 지원되는 대상을 확인하고 하나를 선택합니다:
하나의 릴리스 빌드 로그를 따라가려면:

​
리전 및 GPU 가용성

리전 용량은 변동되므로 배포 대상을 선택할 때 플랫폼 카탈로그를 확인하세요. --region <region>으로 결과를 필터링할 수 있습니다:
카탈로그는 배포 시점에 각 리전에서 어떤 GPU 클래스가 제공되는지에 대한 기준 소스입니다.

​
워크스페이스 한도

워크스페이스의 사용량과 플랜 한도는 한도를 참조하세요. --max는 배포당 워커 한도 안에서 유지하세요.

​
배포 모니터링 및 호출

--min 및 --max 옵션은 워커 범위를 설정합니다. comfy deploy status --watch를 실행하면 배포 상태, 릴리스 최신 상태, 서비스 활동을 계속 확인할 수 있습니다. Comfy SDK로 엔드포인트를 호출할 수도 있습니다. COMFY_BASE_URL을 배포 URL로 설정하고 API 키를 제공하세요. 기본 URL 선택을 참조하세요.

​
배포 운영

​
검사 및 정리

배포 삭제와 빌드 삭제는 서로 별개의 되돌릴 수 없는 작업입니다. comfy deploy delete --yes 또는 comfy build delete --id bld_123456 --yes를 사용하기 전에 대상을 확인하세요.

​
FAQ

네. 빌더에서 하나 이상의 워크플로를 업로드하면 해당 모델과 커스텀 노드가 미리 선택됩니다. 실행할 모든 워크플로에 필요한 의존성을 포함한 다음, 각 API 형식 워크플로를 배포된 엔드포인트에 제출하세요.각 배포는 하나의 GPU 유형을 사용합니다. 서로 다른 GPU 유형에서 워크플로를 실행하려면 동일한 빌드로 별도의 배포를 생성하세요.
아니요. 빌드와 릴리스는 계정에 무료로 저장됩니다. 배포하기 전까지는 빌드의 저장 공간에 대한 비용이 청구되지 않습니다.저장 비용 청구는 배포와 함께 시작됩니다:
  • 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. comfy deploy stop으로 배포를 일시 중지한 상태도 포함됩니다.
  • 각 워커는 고정된 50 GB 컨테이너 디스크도 함께 받습니다. 이 디스크는 임시이며 워커가 실행 중일 때만 워커의 컴퓨팅 비용의 일부로 청구됩니다.
  • 배포를 삭제하면 해당 컴퓨팅이 해제됩니다. 스테이징된 네트워크 스토리지는 해당 리전에서 이를 사용하는 마지막 배포가 삭제된 직후 정리되고, 그에 대한 청구도 종료됩니다.
현재 저장 요금은 Comfy 가격 페이지를 참조하세요. 컴퓨팅 카탈로그(comfy deploy refs compute)와 배포 대화 상자에서도 배포에 적용되는 요금을 확인할 수 있습니다.
--min은 활성 워커 수를 설정합니다. 활성 워커는 항상 실행 상태를 유지하여 요청이 콜드 스타트를 기다리지 않도록 하는 워커입니다. 활성 워커는 작업을 처리 중인지 여부와 관계없이 실행되는 전체 시간에 대해 초 단위로 청구됩니다.--min을 초과하고 --max까지의 워커는 플렉스 워커입니다. 플렉스 워커는 시작되는 순간부터(시작 및 모델 로딩 포함) 작업 처리, 그리고 축소되기 전의 짧은 유휴 구간(현재 30초)까지 초 단위로 청구됩니다. 플렉스 워커가 축소되면 비용이 발생하지 않습니다. --min 0이면 전체 배포가 0으로 축소되어 유휴 상태에서는 컴퓨팅 비용이 청구되지 않지만, 첫 요청 시 콜드 스타트가 발생합니다.청구는 실제 초 단위 워커 사용량에 실행 중인 워커 수를 곱해 측정됩니다. 워크스페이스의 크레딧이 소진되면 배포가 자동으로 중지됩니다.현재 워커당 GPU 요금은 Comfy 가격 페이지를 참조하세요. 요금은 워커-시간 기준으로 제시되며 초 단위로 청구됩니다. 리전별 GPU 가용성은 컴퓨팅 카탈로그에서 확인할 수 있습니다. 현재 목록은 comfy deploy refs compute를 실행하세요.
배포는 요청을 워커 전체에 자동으로 분산하고, 설정된 --min 및 --max 범위 내에서 확장합니다. 즉시 실행할 수 없는 요청은 대기 중으로 들어가 워커 용량이 확보되는 대로 처리됩니다.
배포 상태를 확인한 다음, 로그와 이벤트를 검사하여 원인을 파악하세요:
선택한 GPU나 리전에 가용 용량이 없으면 나중에 다시 시도하거나 comfy deploy refs compute를 실행하여 사용 가능한 리전과 GPU 조합을 선택하세요. 도움을 요청할 때는 빌드, 릴리스, 배포 ID를 함께 알려주세요.
배포를 삭제하면 해당 엔드포인트가 제거되고 컴퓨팅이 해제됩니다. 빌드나 릴리스는 삭제되지 않습니다. 리전에서 해당 빌드를 사용하는 마지막 배포를 삭제하면 스테이징된 네트워크 스토리지가 정리되고 잠시 후 저장 비용 청구가 종료됩니다.빌드 삭제는 별개의 작업입니다: comfy build delete --id <build-id> --yes.

​
다음 단계

Comfy SDKs

Python 또는 TypeScript 앱에서 워크플로를 제출하고 입력, 진행 상황, 출력을 처리할 때 사용합니다.

Comfy API v2

HTTP API를 직접 호출하거나 요청 및 응답 형식을 확인할 때 모든 언어에서 사용합니다.

워크플로 API 형식

API 요청용 워크플로 JSON을 준비하거나 입력과 출력을 트러블슈팅할 때 사용합니다.

Comfy CLI 레퍼런스

터미널에서 Build, 릴리스, 배포, 워크플로 명령을 자동화할 때 사용합니다.