> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy API: 서버리스 배포

> 버전 관리되는 ComfyUI 환경을 빌드하고, 관리형 엔드포인트로 배포한 뒤 API를 통해 워크플로를 실행합니다.

Comfy API를 사용하면 앱에서 관리형 엔드포인트를 통해 ComfyUI 워크플로를 실행할 수 있습니다. 워크플로에 필요한 ComfyUI 버전, 모델, 커스텀 노드, 종속성을 패키징하면 Comfy가 관리형 GPU에서 실행합니다. 반복 가능한 환경과 앱에서 호출할 엔드포인트가 필요할 때 사용하세요.

## 플랫폼 개념

| 개념 | 의미 |
| - | - |
| **워크스페이스** | 멤버, Build, 배포, 사용량 한도를 관리하는 팀 계정입니다. |
| **Build** | ComfyUI 버전, 모델, 커스텀 노드, 종속성을 포함하는 환경 정의입니다. |
| **Build 버전 / 릴리스** | `linux/nvidia`와 같은 배포 대상을 위해 준비된 번호가 지정된 Build입니다. |
| **배포** | 릴리스를 실행하는 엔드포인트로, 자체 GPU, 리전, 워커 설정이 있습니다. |

[Comfy Cloud](/ko/development/deploy/cloud)에서 지원하는 워크플로는 Build나 배포 없이 실행할 수 있습니다.

<Card title="Comfy API 빠른 시작" icon="play" href="/ko/development/serverless/quickstart">
  에이전트로 시작하거나 환경 또는 워크플로를 제공하는 다른 방법을 선택하세요.
</Card>

Desktop 스냅샷과 워크플로 JSON 가져오기에 대해서는 [Build 소스](/ko/development/serverless/build-sources)를 참조하세요.

## 빌드 파일

`comfy-build.yaml`은 Build 정의와 마지막으로 확인된 원격 상태를 저장합니다. CLI는 이 상태를 사용해 원격 Build가 변경되었는지 감지합니다. 이 파일은 프로젝트와 함께 보관하세요. 환경을 설명하는 파일이며 모델 파일은 포함하지 않습니다.

변경 사항을 푸시하기 전에 로컬 Build가 설치된 내용 및 원격 버전과 어떻게 다른지 확인합니다:

```bash theme={null}
comfy build status
```

## 업데이트 및 릴리스

로컬 설치를 변경한 뒤에는 Build 정의를 새로 고칩니다:

```bash theme={null}
comfy build update --yes
```

기존 Build에서 다른 릴리스를 만들려면 지원되는 대상을 확인하고 하나를 선택합니다:

```bash theme={null}
comfy build refs build-targets
comfy build release create --target linux/nvidia --watch
```

하나의 릴리스 빌드 로그를 따라가려면:

```bash theme={null}
comfy build release logs rel_123456 --target linux/nvidia --follow
```

## 리전 및 GPU 가용성

리전 용량은 변동되므로 배포 대상을 선택할 때 플랫폼 카탈로그를 확인하세요. `--region <region>`으로 결과를 필터링할 수 있습니다:

```bash theme={null}
comfy deploy refs compute --region <region>
```

카탈로그는 배포 시점에 각 리전에서 어떤 GPU 클래스가 제공되는지에 대한 기준 소스입니다.

## 워크스페이스 한도

워크스페이스의 사용량과 플랜 한도는 [한도](https://platform.comfy.org/profile/limits)를 참조하세요. `--max`는 배포당 워커 한도 안에서 유지하세요.

## 배포 모니터링 및 호출

`--min` 및 `--max` 옵션은 워커 범위를 설정합니다. `comfy deploy status --watch`를 실행하면 배포 상태, 릴리스 최신 상태, 서비스 활동을 계속 확인할 수 있습니다.

[Comfy SDK](/ko/development/api-development/sdks)로 엔드포인트를 호출할 수도 있습니다. `COMFY_BASE_URL`을 배포 URL로 설정하고 API 키를 제공하세요. [기본 URL 선택](/ko/development/api-development/sdks#기본-url-선택)을 참조하세요.

## 배포 운영

```bash theme={null}
# 워커 범위 변경
comfy deploy scale --deployment dep_123456 --min 2 --max 5

# 배포 기록을 유지한 채 일시 중지하거나 재개
comfy deploy stop --deployment dep_123456
comfy deploy start --deployment dep_123456
```

## 검사 및 정리

```bash theme={null}
# 빌드 상태
comfy build ls
comfy build show --id bld_123456
comfy build release ls
comfy build release show rel_123456

# 배포 상태
comfy deploy ls --workspace --status ready
comfy deploy logs --deployment dep_123456
comfy deploy events --deployment dep_123456
```

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

## FAQ

<AccordionGroup>
  <Accordion title="하나의 빌드를 여러 워크플로에서 만들 수 있나요?">
    네. 빌더에서 하나 이상의 워크플로를 업로드하면 해당 모델과 커스텀 노드가 미리 선택됩니다. 실행할 모든 워크플로에 필요한 의존성을 포함한 다음, 각 API 형식 워크플로를 배포된 엔드포인트에 제출하세요.

    각 배포는 하나의 GPU 유형을 사용합니다. 서로 다른 GPU 유형에서 워크플로를 실행하려면 동일한 빌드로 별도의 배포를 생성하세요.
  </Accordion>

  <Accordion title="배포하지 않은 빌드를 저장하는 데에도 비용이 청구되나요?">
    아니요. 빌드와 릴리스는 계정에 무료로 저장됩니다. 배포하기 전까지는 빌드의 저장 공간에 대한 비용이 청구되지 않습니다.

    저장 비용 청구는 배포와 함께 시작됩니다:

    * 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. `comfy deploy stop`으로 배포를 일시 중지한 상태도 포함됩니다.
    * 각 워커는 고정된 50 GB 컨테이너 디스크도 함께 받습니다. 이 디스크는 임시이며 워커가 실행 중일 때만 워커의 컴퓨팅 비용의 일부로 청구됩니다.
    * 배포를 삭제하면 해당 컴퓨팅이 해제됩니다. 스테이징된 네트워크 스토리지는 해당 리전에서 이를 사용하는 마지막 배포가 삭제된 직후 정리되고, 그에 대한 청구도 종료됩니다.

    현재 저장 요금은 [Comfy 가격 페이지](https://www.comfy.org/pricing)를 참조하세요. 컴퓨팅 카탈로그(`comfy deploy refs compute`)와 배포 대화 상자에서도 배포에 적용되는 요금을 확인할 수 있습니다.
  </Accordion>

  <Accordion title="활성 워커는 어떻게 청구되며, 시간당 요금은 얼마인가요?">
    `--min`은 **활성 워커** 수를 설정합니다. 활성 워커는 항상 실행 상태를 유지하여 요청이 콜드 스타트를 기다리지 않도록 하는 워커입니다. 활성 워커는 작업을 처리 중인지 여부와 관계없이 실행되는 전체 시간에 대해 초 단위로 청구됩니다.

    `--min`을 초과하고 `--max`까지의 워커는 **플렉스 워커**입니다. 플렉스 워커는 시작되는 순간부터(시작 및 모델 로딩 포함) 작업 처리, 그리고 축소되기 전의 짧은 유휴 구간(현재 30초)까지 초 단위로 청구됩니다. 플렉스 워커가 축소되면 비용이 발생하지 않습니다. `--min 0`이면 전체 배포가 0으로 축소되어 유휴 상태에서는 컴퓨팅 비용이 청구되지 않지만, 첫 요청 시 콜드 스타트가 발생합니다.

    청구는 실제 초 단위 워커 사용량에 실행 중인 워커 수를 곱해 측정됩니다. 워크스페이스의 크레딧이 소진되면 배포가 자동으로 중지됩니다.

    현재 워커당 GPU 요금은 [Comfy 가격 페이지](https://www.comfy.org/pricing)를 참조하세요. 요금은 워커-시간 기준으로 제시되며 초 단위로 청구됩니다. 리전별 GPU 가용성은 컴퓨팅 카탈로그에서 확인할 수 있습니다. 현재 목록은 `comfy deploy refs compute`를 실행하세요.
  </Accordion>

  <Accordion title="배포는 여러 요청을 어떻게 처리하나요?">
    배포는 요청을 워커 전체에 자동으로 분산하고, 설정된 `--min` 및 `--max` 범위 내에서 확장합니다. 즉시 실행할 수 없는 요청은 대기 중으로 들어가 워커 용량이 확보되는 대로 처리됩니다.
  </Accordion>

  <Accordion title="프로비저닝이 오래 걸리면 어떻게 해야 하나요?">
    배포 상태를 확인한 다음, 로그와 이벤트를 검사하여 원인을 파악하세요:

    ```bash theme={null}
    comfy deploy status --deployment <deployment-id> --watch
    comfy deploy logs --deployment <deployment-id>
    comfy deploy events --deployment <deployment-id>
    ```

    선택한 GPU나 리전에 가용 용량이 없으면 나중에 다시 시도하거나 `comfy deploy refs compute`를 실행하여 사용 가능한 리전과 GPU 조합을 선택하세요. 도움을 요청할 때는 빌드, 릴리스, 배포 ID를 함께 알려주세요.
  </Accordion>

  <Accordion title="배포를 삭제하면 어떻게 되나요?">
    배포를 삭제하면 해당 엔드포인트가 제거되고 컴퓨팅이 해제됩니다. 빌드나 릴리스는 삭제되지 않습니다. 리전에서 해당 빌드를 사용하는 마지막 배포를 삭제하면 스테이징된 네트워크 스토리지가 정리되고 잠시 후 저장 비용 청구가 종료됩니다.

    빌드 삭제는 별개의 작업입니다: `comfy build delete --id <build-id> --yes`.
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="Comfy SDKs" icon="code" href="/ko/development/api-development/sdks">
    Python 또는 TypeScript 앱에서 워크플로를 제출하고 입력, 진행 상황, 출력을 처리할 때 사용합니다.
  </Card>

  <Card title="Comfy API v2" icon="cloud" href="/ko/api-reference/v2/overview">
    HTTP API를 직접 호출하거나 요청 및 응답 형식을 확인할 때 모든 언어에서 사용합니다.
  </Card>

  <Card title="워크플로 API 형식" icon="file-code" href="/ko/development/api-development/workflow-api-format">
    API 요청용 워크플로 JSON을 준비하거나 입력과 출력을 트러블슈팅할 때 사용합니다.
  </Card>

  <Card title="Comfy CLI 레퍼런스" icon="terminal" href="/ko/comfy-cli/reference">
    터미널에서 Build, 릴리스, 배포, 워크플로 명령을 자동화할 때 사용합니다.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.