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

# API 개요

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

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

***

## 여기서 시작

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

<Card title="Comfy SDKs" icon="code" href="/ko/development/api-development/sdks">
  자체 애플리케이션에서 워크플로를 실행하기 위한 공식 Python 및 TypeScript SDK입니다. 현재 베타 버전입니다.
</Card>

아래의 다른 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 형식](/ko/development/api-development/workflow-api-format))을 사용하므로, 워크플로를 로컬에서 개발하고 테스트한 다음 변경 없이 클라우드로 이동할 수 있습니다.

## 시작하기

<CardGroup cols={2}>
  <Card title="Comfy SDK" icon="code" href="/ko/development/api-development/sdks">
    Python 또는 TypeScript에서 클라우드 또는 자체 머신을 대상으로 워크플로를 실행하세요.
  </Card>

  <Card title="클라우드 API" icon="cloud" href="/ko/development/cloud/overview">
    Comfy의 관리형 인프라에서 워크플로를 실행하세요. GPU 설정이 필요 없습니다.
  </Card>

  <Card title="ComfyUI 서버 API" icon="server" href="/ko/development/comfyui-server/comms_overview">
    자체 머신에서 ComfyUI를 서버로 실행하고 API를 통해 호출하세요.
  </Card>

  <Card title="파트너 노드 API 연동" icon="key" href="/ko/development/comfyui-server/api-key-integration">
    헤드리스 또는 API 기반 워크플로에서 유료 파트너 노드를 사용하세요.
  </Card>
</CardGroup>

***

## 사전 준비 사항

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

* Comfy Cloud 또는 파트너 노드와 관련된 모든 작업에는 API 키가 필요합니다([API 키 받기](/ko/development/api-development/getting-an-api-key) 참조). 완전히 로컬에서 실행되는 ComfyUI는 API 키가 필요하지 않습니다.