메인 콘텐츠로 건너뛰기
실험적 API: 이 API는 실험적인 것으로, 변경될 수 있습니다. 엔드포인트, 요청/응답 형식 및 동작은 사전 통지 없이 수정될 수 있습니다.

Comfy Cloud API 사양

이 페이지는 Comfy Cloud API의 완전한 OpenAPI 3.0 사양을 제공합니다.
구독 필요: API를 통해 워크플로우를 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 자세한 내용은 가격 계획을 참조하세요.

대화형 API 참조

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

Cloud API 참조

엔드포인트 둘러보기, 스키마 보기 및 요청 시도하기

사양 사용하기

OpenAPI 사양은 다음에 사용할 수 있습니다:
  • OpenAPI Generator와 같은 도구를 사용해 모든 언어의 클라이언트 라이브러리 생성
  • Postman, Insomnia 또는 Paw와 같은 API 도구로 가져오기
  • Redoc 또는 Swagger UI와 같은 도구를 사용해 문서 생성
  • 애플리케이션에서 요청 검증

다운로드

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

openapi-cloud.yaml

OpenAPI 3.0 사양 다운로드하기

인증

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

API 키 얻기

단계별 지침과 스크린샷은 API 키 얻기를 참조하세요.

API 키 사용하기

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 참조를 참조하세요.