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

# Comfy API v2 개요

<Warning>
  **베타:** Comfy API v2는 `0.1.x` 버전이며 API 표면은 여전히 변경될 수 있습니다. v2 내 변경 사항은 추가적으로 제공됩니다. 호환성을 깨뜨리는 변경은 v3로 출시됩니다.
</Warning>

외부 애플리케이션에서 ComfyUI 워크플로를 실행하기 위한 공식 버전 관리 HTTP API입니다: 입력 업로드, 워크플로 제출, 실행 관찰, 결과 검색.

대부분의 사용자는 이 API를 Python과 TypeScript로 래핑한 [Comfy SDKs](/ko/development/api-development/sdks)부터 시작해야 합니다. 다른 언어로 작업하는 경우 이러한 엔드포인트를 직접 호출하세요.

## 설계 원칙

* **폴링 우선.** 모든 기능은 일반 GET 폴링으로 접근할 수 있습니다. SSE 스트림은 실시간 개선 사항일 뿐, 결코 진실의 원천은 아닙니다.
* **모든 것은 재개 가능합니다.** 제출은 멱등적이며, 작업 상태와 출력은 `expires_at`까지 ID로 검색할 수 있습니다.
* **콘텐츠 주소 지정 에셋.** 에셋은 서버에서 계산된 blake3 해시를 키로 하는 blob에 대한 UUID 식별 레코드입니다. 따라서 동일한 입력이 두 번 업로드되지 않습니다.
* **링크를 따르고 URL을 직접 만들지 마세요.** 응답에는 후속 URL이 포함되어 있습니다.

이러한 설계 원칙에 대한 근거는 [디자인 노트](/ko/development/api-development/sdks-design)를 참조하세요.

## 기본 URL

| 환경                                                                         | URL                       | 인증                                |
| -------------------------------------------------------------------------- | ------------------------- | --------------------------------- |
| Comfy Cloud                                                                | `https://cloud.comfy.org` | `Authorization: Bearer <api-key>` |
| 자체 호스팅, [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) 경유 | `http://127.0.0.1:8189`   | 기본적으로 없음, 선택적 정적 Bearer 토큰        |

## 엔드포인트 카테고리

| 카테고리 | 설명                                                             |
| ---- | -------------------------------------------------------------- |
| 에셋   | 콘텐츠 주소 지정 blob을 기반으로 하는 UUID 식별 레코드입니다. 입력을 업로드하고 출력을 다운로드합니다. |
| 작업   | 워크플로의 단일 실행입니다. 영속적이며, 폴링 가능하고, 취소 가능합니다.                      |