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

# 파트너 노드

> 이 기사에서는 ComfyUI의 파트너 노드와 관련 정보를 소개하겠습니다.

파트너 노드는 ComfyUI가 API 요청을 통해 폐쇄형 모델을 호출하는 새로운 방식으로, 복잡한 API 키 설정 없이 ComfyUI 사용자들이 외부의 최신 AI 모델에 접근할 수 있도록 제공합니다.

## 파트너 노드란 무엇인가요?

파트너 노드는 외부 API 서비스와 연결되는 특수한 노드 세트로, 폐쇄형 또는 타사에서 호스팅하는 AI 모델을 바로 ComfyUI 워크플로우에서 사용할 수 있게 해줍니다. 이러한 노드들은 외부 모델의 기능을 원활하게 통합하면서도 ComfyUI 핵심의 오픈소스 성격을 유지하도록 설계되었습니다.

## 파트너 노드 사용을 위한 사전 요구사항

파트너 노드를 사용하려면 다음의 요구사항을 충족해야 합니다:

### 1. ComfyUI 버전 요구사항

ComfyUI를 최신 버전으로 업데이트해 주세요. 향후 더 많은 API 지원이 추가될 수 있으며, 이에 맞춰 해당 노드도 업데이트될 예정이므로 항상 ComfyUI를 최신 상태로 유지해 주시기 바랍니다.

<Tip>
  야간 빌드와 릴리스 버전 간의 차이점을 유의해 주세요. 릴리스 버전은 적시에 업데이트되지 않을 수 있으므로, `야간 빌드` 버전(최신 코드 커밋)을 사용하는 것을 권장합니다.\
  이는 개발 버전과 안정화 버전을 의미하며, 저희가 여전히 빠르게 반복 개발 중이므로 본 문서는 신속하게 업데이트되지 않을 수 있습니다. 따라서 버전 차이에 유의해 주시기 바랍니다.
</Tip>

### 2. 계정 및 크레딧 요구사항

[Comfy 계정](/ko/interface/user)으로 ComfyUI에 로그인되어 있어야 하며, [크레딧](/ko/interface/credits) 잔액이 0보다 많아야 합니다.

`설정` -> `사용자`를 통해 로그인하세요:

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/interface/setting/user.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=066170b38e0b9ead026029685e00fa65" alt="ComfyUI 사용자 인터페이스" width="3358" height="1828" data-path="images/interface/setting/user.jpg" />

`설정` -> `크레딧`으로 이동하여 크레딧을 구매하세요:

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/interface/setting/purchase-1.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=a324b33ce2d6dce5bf2d0e895ac0d1eb" alt="크레딧 인터페이스" width="3358" height="1828" data-path="images/interface/setting/purchase-1.jpg" />

계정 및 크레딧 관련 자세한 내용은 다음 문서를 참조해 주세요:

* [Comfy 계정](/ko/interface/user): 설정 메뉴에서 `사용자` 섹션을 찾아 로그인하세요.
* [크레딧](/ko/interface/credits): 로그인 후 설정 인터페이스에 크레딧 메뉴가 표시되며, 여기서 크레딧을 구매할 수 있습니다. 저희는 선불 방식을 사용하므로 예상치 못한 요금 청구는 없습니다.

### 3. 네트워크 환경 요구사항

API 접근을 위해서는 현재 요청이 안전한 네트워크 환경을 기반으로 해야 합니다. API 접근을 위한 현재 요구사항은 다음과 같습니다:

* 로컬 네트워크는 `127.0.0.1` 또는 `localhost`로부터만 접속을 허용하며, 직접 로그인 기능을 사용할 수 있습니다.
* 만약 로컬 네트워크나 화이트리스트에 등록되지 않은 웹사이트에서 접근하려는 경우, API Key를 사용해 로그인해 주세요. [API Key로 로그인하기](/ko/interface/user#logging-in-with-an-api-key)를 참고해 주세요.
* 당사의 API 서비스에 정상적으로 접근할 수 있어야 합니다(일부 지역에서는 프록시 서비스를 이용해야 할 수도 있습니다).
* 요청의 보안을 확보하기 위해 `https` 환경에서 접근해야 합니다.

<Note>
  비안전한 환경에서 접근하면 큰 위험이 따르며, 다음과 같은 결과를 초래할 수 있습니다:

  1. 인증 정보가 도난당해 계정 정보가 유출될 수 있습니다.
  2. 악의적으로 계정이 사용되어 금전적 손실이 발생할 수 있습니다.

  향후 이 제한을 해제하더라도, 비안전한 네트워크 요청을 통해 API 서비스에 접근하는 것은 매우 위험하므로 절대 권장하지 않습니다.
</Note>

### 4. 해당 노드 사용하기

**워크플로우에 추가**: 다른 노드와 마찬가지로 파트너 노드를 워크플로우에 추가하세요.
**실행**: 매개변수를 설정한 후 워크플로우를 실행하세요.

<img src="https://mintcdn.com/dripart/iA0B1fSEOunjmr8W/images/tutorial/api_nodes/sidebar.jpg?fit=max&auto=format&n=iA0B1fSEOunjmr8W&q=85&s=5adc8f697864ac7d890722dddbb8260c" alt="파트너 노드" width="1056" height="1836" data-path="images/tutorial/api_nodes/sidebar.jpg" />

## 화이트리스트에 등록되지 않은 웹사이트에서 ComfyUI 계정 API 키로 로그인하기

현재 우리는 ComfyUI 계정에 로그인할 수 있는 웹사이트를 제한하기 위해 화이트리스트를 설정했습니다. 만약 일부 화이트리스트에 등록되지 않은 웹사이트에서 ComfyUI 계정에 로그인해야 한다면, 계정 관리 섹션을 참고해 API 키를 이용한 로그인 방법을 알아보세요. 이 경우 해당 웹사이트가 우리의 화이트리스트에 반드시 등록되어 있을 필요는 없습니다.

<Card title="계정 관리" icon="book" href="/ko/interface/user#logging-in-with-an-api-key">
  ComfyUI 계정 API 키로 로그인하는 방법 알아보기
</Card>

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/interface/setting/user/user-login-api-1.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=bdb8d99a4bd52a6cc1de1b3453e8cfda" alt="Comfy API 키 로그인 선택" width="3450" height="1914" data-path="images/interface/setting/user/user-login-api-1.jpg" />

## ComfyUI 계정 API 키 통합을 이용해 유료 모델 파트너 노드 호출하기

현재 우리는 ComfyUI API 키 통합을 통해 유료 모델 파트너 노드를 호출하는 서비스에 접근할 수 있도록 지원하고 있습니다. API 키 통합 섹션을 참고해 유료 모델 파트너 노드를 호출하는 방법을 알아보세요.

<Note>
  **중요:** 여기서 다루는 API 키는 귀하의 **ComfyUI 계정 API 키**(워크플로우에서 유료 파트너 노드에 접근하는 데 사용됨)입니다. 이는 개발자가 커스텀 노드를 레지스트리에 게시하는 데 사용하는 **레지스트리 게시 API 키**와는 **다릅니다**. 커스텀 노드를 게시하려면 [노드 게시](/ko/registry/publishing)를 참조하세요.
</Note>

<Card title="API 키 통합" icon="link" href="/ko/development/comfyui-server/api-key-integration">
  API 키 통합 섹션을 참고해 유료 모델 파트너 노드를 호출하는 방법 알아보기
</Card>

## 파트너 노드의 장점

파트너 노드는 ComfyUI 사용자들에게 다음과 같은 중요한 장점을 제공합니다:

* **폐쇄형 모델 접근**: 직접 배포할 필요 없이 최신 AI 모델을 사용할 수 있습니다
* **원활한 통합**: 파트너 노드는 다른 ComfyUI 노드와 완벽히 호환되며, 이를 조합해 복잡한 워크플로우를 만들 수 있습니다
* **간편한 경험**: API 키를 관리하거나 복잡한 API 요청을 처리할 필요가 없습니다
* **비용 통제**: 선불 시스템 덕분에 예상치 못한 비용 없이 지출을 완벽히 관리할 수 있습니다

## 가격 정책

<Card title="파트너 노드 가격 정책" icon="coin" href="/ko/tutorials/partner-nodes/pricing">
  해당 파트너 가격 정책 페이지를 참고하세요
</Card>

## 오픈소스 및 옵트인에 대하여

**파트너 노드는 완전히 선택적**이라는 점에 유의하세요. ComfyUI는 언제나 완전히 오픈소스이며, 지역 사용자에게 무료로 제공됩니다. 파트너 노드는 '옵트인' 기능으로 설계되어, 외부 SOTA(최신) 모델에 접근하고자 하는 사용자들에게 편의를 제공합니다.

## 파트너 노드를 완전히 비활성화하는 방법

ComfyUI에서 모든 파트너 노드를 비활성화하려면 `--disable-api-nodes` 실행 인자를 추가하면 됩니다. 이 인자는 프론트엔드가 인터넷과 통신하지 못하도록 막습니다.

**수동 설치용:**

```bash theme={null}
python main.py --disable-api-nodes
```

**휴대용 사용자용 (윈도우):**

`run_xxx.bat` 파일을 업데이트하세요:

```batch theme={null}
.\python_embeded\python.exe -s ComfyUI\main.py --listen --windows-standalone-build --disable-api-nodes
pause
```

## 활용 사례

파트너 노드의 강력한 응용 사례 중 하나는 외부 모델의 출력을 로컬 노드와 결합하는 것입니다. 예를 들어:

* GPT-Image-1을 사용해 기본 이미지를 생성한 후, 로컬 `wan` 노드로 이를 동영상으로 변환하기
* 외부에서 생성된 이미지를 로컬 업스케일링이나 스타일 전송 노드와 결합하기
* 폐쇄형 모델과 오픈소스 모델의 장점을 모두 활용한 하이브리드 워크플로우 만들기

이러한 유연성 덕분에 ComfyUI는 다양한 AI 기능을 통합한 진정한 범용 생성 AI 인터페이스가 되었으며, 더 많은 가능성을 열어줍니다.

## FAQ

<AccordionGroup>
  <Accordion title="왜 파트너 노드를 찾을 수 없나요?">
    ComfyUI를 최신 버전으로 업데이트해 주세요(최신 커밋 또는 최신 [데스크톱 버전](https://www.comfy.org/download)). 향후 더 많은 API 지원을 추가하고 해당 노드도 업데이트될 예정이니, ComfyUI를 항상 최신 상태로 유지해 주세요.

    <Tip>
      야간 빌드와 릴리즈 버전을 구분해야 한다는 점에 유의해 주세요. 경우에 따라 최신 `릴리즈` 버전이 `야간` 버전보다 제때 업데이트되지 않을 수 있습니다. 아직 빠르게 반복 개발 중이므로, 해당 노드를 찾을 수 없는 경우 반드시 최신 버전을 사용해 주세요.
    </Tip>
  </Accordion>

  <Accordion title="왜 파트너 노드를 사용하거나 로그인할 수 없나요?">
    API 접근을 위해서는 현재 요청이 안전한 네트워크 환경을 기반으로 해야 합니다. 현재 API 접근 요구사항은 다음과 같습니다:

    * 로컬 네트워크는 `127.0.0.1` 또는 `localhost`에서만 접속을 허용하므로, LAN 환경에서 `--listen` 매개변수로 시작된 ComfyUI 서비스에서는 파트너 노드를 사용할 수 없습니다.
    * 당사 API 서비스에 정상적으로 접근 가능해야 합니다(일부 지역에서는 프록시 서비스가 필요할 수 있음).
    * 계정에 충분한 [크레딧](/ko/interface/credits)이 있어야 합니다.
  </Accordion>

  <Accordion title="로그인 후에도 왜 파트너 노드를 사용할 수 없거나 계속해서 로그인을 요구하나요?">
    * 현재 `127.0.0.1` 또는 `localhost` 접속만 지원됩니다.
    * 계정에 충분한 크레딧이 있는지 확인해 주세요.
  </Accordion>

  <Accordion title="파트너 노드는 무료로 사용할 수 있나요?">
    파트너 노드는 폐쇄형 모델에 대한 API 호출에 크레딧이 필요하므로, 무료 사용을 지원하지 않습니다.
  </Accordion>

  <Accordion title="크레딧을 어떻게 구매하나요?">
    다음 문서를 참고해 주세요:

    1. [Comfy 계정](/ko/interface/user): 설정 메뉴에서 `사용자` 섹션을 찾아 로그인하세요.
    2. [크레딧](/ko/interface/credits): 로그인 후 설정 인터페이스에 크레딧 메뉴가 표시됩니다. `설정` → `크레딧`에서 크레딧을 구매할 수 있습니다. 선불 방식을 사용하므로 예상치 못한 요금 청구는 없습니다.
    3. Stripe를 통해 결제를 완료하세요.
    4. 크레딧이 업데이트되었는지 확인하세요. 그렇지 않은 경우 페이지를 다시 시작하거나 새로고침해 보세요.
  </Accordion>

  <Accordion title="미사용 크레딧은 환불받을 수 있나요?">
    현재 크레딧에 대한 환불은 지원되지 않습니다. 기술적 문제로 인해 미사용 잔액이 발생했다고 판단되는 경우, [지원팀에 문의](mailto:support@comfy.org)해 주세요.
  </Accordion>

  <Accordion title="크레딧이 마이너스로 갈 수 있나요?">
    크레딧은 마이너스 잔액이나 신용 한도로 사용하도록 설계되지 않았습니다. 그러나 경합 조건으로 인해 파트너 노드가 실행 전에 항상 비용을 보고하지 않는 경우, 한 번의 실행으로 남은 잔액보다 더 많은 크레딧을 소모해 일시적으로 마이너스 잔액이 될 수 있습니다. 잔액이 마이너스인 경우, 충전해 양수 잔액을 복원할 때까지 파트너 노드를 실행할 수 없습니다. API 호출 전에 충분한 크레딧이 있는지 확인해 주세요.
  </Accordion>

  <Accordion title="사용량과 지출 내역은 어디서 확인할 수 있나요?">
    로그인 후 [크레딧](/ko/interface/credits) 메뉴를 방문해 해당 크레딧을 확인해 주세요.
  </Accordion>

  <Accordion title="내 API 키를 사용할 수 있나요?">
    현재 파트너 노드는 아직 테스트 단계이며 이 기능을 지원하지 않지만, 추가하는 것을 고려하고 있습니다.
  </Accordion>

  <Accordion title="크레딧은 만료되나요?">
    예, 만료 기간은 크레딧 종류에 따라 다릅니다:

    * **월간 크레딧**: 청구 주기 종료 시 만료
    * **충전형 크레딧**: 구매일로부터 1년 후 만료
  </Accordion>

  <Accordion title="크레딧을 이전하거나 공유할 수 있나요?">
    아니요, 귀하의 크레딧은 다른 사용자에게 이전할 수 없으며 현재 로그인된 계정에만 한정됩니다. 다만, 로그인 가능한 기기 수에는 제한이 없습니다.
  </Accordion>

  <Accordion title="동일한 계정을 여러 기기에서 사용할 수 있나요?">
    로그인 가능한 기기 수에는 제한이 없으므로, 원하는 곳에서 계정을 사용할 수 있습니다.
  </Accordion>

  <Accordion title="내 계정이나 정보를 삭제해 달라고 요청하려면 어떻게 하나요?">
    [support@comfy.org](mailto:support@comfy.org)로 이메일을 보내주시면 귀하의 정보를 삭제해 드립니다.
  </Accordion>
</AccordionGroup>