> ## 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.

# OpenAPI 사양

> Comfy Cloud API용 기계가 읽을 수 있는 OpenAPI 사양

<Warning>
  **실험적 API:** 이 API는 실험적인 것으로, 변경될 수 있습니다. 엔드포인트, 요청/응답 형식 및 동작은 사전 통지 없이 수정될 수 있습니다.
</Warning>

# Comfy Cloud API 사양

이 페이지는 Comfy Cloud API의 완전한 OpenAPI 3.0 사양을 제공합니다.

<Note>
  **구독 필요:** API를 통해 워크플로우를 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 자세한 내용은 [가격 계획](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api)을 참조하세요.
</Note>

## 대화형 API 참조

대화형 문서를 통해 전체 API를 탐색해 보세요:

<Card title="Cloud API 참조" icon="code" href="/ko/api-reference/cloud/overview">
  엔드포인트 둘러보기, 스키마 보기 및 요청 시도하기
</Card>

## 사양 사용하기

OpenAPI 사양은 다음에 사용할 수 있습니다:

* [OpenAPI Generator](https://openapi-generator.tech/)와 같은 도구를 사용해 모든 언어의 클라이언트 라이브러리 생성
* Postman, Insomnia 또는 Paw와 같은 API 도구로 가져오기
* Redoc 또는 Swagger UI와 같은 도구를 사용해 문서 생성
* 애플리케이션에서 요청 검증

## 다운로드

원시 OpenAPI 사양 파일을 다운로드할 수 있습니다:

<Card title="openapi-cloud.yaml" icon="download" href="https://raw.githubusercontent.com/Comfy-Org/docs/main/openapi-cloud.yaml">
  OpenAPI 3.0 사양 다운로드하기
</Card>

## 인증

모든 API 요청에는 `X-API-Key` 헤더에 전달된 API 키가 필요합니다.

### API 키 얻기

단계별 지침과 스크린샷은 [API 키 얻기](/ko/development/api-development/getting-an-api-key)를 참조하세요.

### API 키 사용하기

```yaml theme={null}
X-API-Key: your-api-key
```

## 기본 URL

| 환경   | URL                       |
| ---- | ------------------------- |
| 프로덕션 | `https://cloud.comfy.org` |

## WebSocket 연결

실시간 업데이트를 위해 WebSocket 엔드포인트에 연결하세요:

```
wss://cloud.comfy.org/ws?clientId={uuid}&token={api_key}
```

메시지 유형 및 처리 방법은 [API 참조](/ko/development/cloud/api-reference#websocket-for-real-time-progress)를 참조하세요.