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

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

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

​
Prerequisites for Using Partner Nodes

To use Partner Nodes, the following requirements must be met:

​
1. ComfyUI Version Requirements

Please update your ComfyUI to the latest version, as we may add more API support in the future, and corresponding nodes will be updated, so please keep your ComfyUI up to date.
Please note the distinction between nightly and release versions. We recommend using the nightly version (which is the latest code commit), as the release version may not be updated in a timely manner. This refers to the development version and the stable version, and since we are still rapidly iterating, this document may not be updated promptly, so please pay attention to the version differences.

​
2. Account and Credits Requirements

You need to be logged into your ComfyUI with a Comfy account and have a credit balance of credits greater than 0. Log in via Settings -> User: ComfyUI User Interface Go to Settings -> Credits to purchase credits Credits Interface Please refer to the corresponding documentation for account and credits to ensure this requirement:
  • Comfy account: Find the User section in the settings menu to log in.
  • Credits: After logging in, the settings interface will show a credits menu where you can purchase credits. We use a prepaid system, so there will be no unexpected charges.

​
3. Network Environment Requirements

API access requires that your current requests are based on a secure network environment. The current requirements for API access are as follows:
  • The local network only allows access from 127.0.0.1 or localhost, and you can directly use the login function.
  • If you are accessing from a local area network or a website that is not on the whitelist, please log in with an API Key. Please refer to Log in with an API Key.
  • You should be able to access our API service normally (in some regions, you may need to use a proxy service).
  • Access should be carried out in an https environment to ensure the security of the requests.
Accessing in an insecure context poses significant risks, which may result in the following consequences:
  1. Authentication may be stolen, leading to the leakage of your account information.
  2. Your account may be maliciously used, resulting in financial losses.
Even if we open this restriction in the future, we strongly advise against accessing API services through insecure network requests due to the high risks involved.

​
4. Using the Corresponding Nodes

Add to Workflow: Add the Partner Node to your workflow just like you would with other nodes. Run: Set the parameters and then run the workflow. Partner Nodes

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

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

계정 관리

ComfyUI 계정 API 키로 로그인하는 방법 알아보기
Comfy API 키 로그인 선택

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

현재 우리는 ComfyUI API 키 통합을 통해 유료 모델 파트너 노드를 호출하는 서비스에 접근할 수 있도록 지원하고 있습니다. API 키 통합 섹션을 참고해 유료 모델 파트너 노드를 호출하는 방법을 알아보세요.
중요: 여기서 다루는 API 키는 귀하의 ComfyUI 계정 API 키(워크플로우에서 유료 파트너 노드에 접근하는 데 사용됨)입니다. 이는 개발자가 커스텀 노드를 레지스트리에 게시하는 데 사용하는 레지스트리 게시 API 키와는 다릅니다. 커스텀 노드를 게시하려면 노드 게시를 참조하세요.

API 키 통합

API 키 통합 섹션을 참고해 유료 모델 파트너 노드를 호출하는 방법 알아보기

​
파트너 노드의 장점

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

​
가격 정책

파트너 노드 가격 정책

해당 파트너 가격 정책 페이지를 참고하세요

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

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

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

ComfyUI에서 모든 파트너 노드를 비활성화하려면 --disable-api-nodes 실행 인자를 추가하면 됩니다. 이 인자는 프론트엔드가 인터넷과 통신하지 못하도록 막습니다. 수동 설치용: 
python main.py --disable-api-nodes
휴대용 사용자용 (윈도우): run_xxx.bat 파일을 업데이트하세요: 
.\python_embeded\python.exe -s ComfyUI\main.py --listen --windows-standalone-build --disable-api-nodes
pause

​
활용 사례

파트너 노드의 강력한 응용 사례 중 하나는 외부 모델의 출력을 로컬 노드와 결합하는 것입니다. 예를 들어:
  • GPT-Image-1을 사용해 기본 이미지를 생성한 후, 로컬 wan 노드로 이를 동영상으로 변환하기
  • 외부에서 생성된 이미지를 로컬 업스케일링이나 스타일 전송 노드와 결합하기
  • 폐쇄형 모델과 오픈소스 모델의 장점을 모두 활용한 하이브리드 워크플로우 만들기
이러한 유연성 덕분에 ComfyUI는 다양한 AI 기능을 통합한 진정한 범용 생성 AI 인터페이스가 되었으며, 더 많은 가능성을 열어줍니다.

​
FAQ

Please update your ComfyUI to the latest version (the latest commit or the latest desktop version). We may add more API support in the future, and the corresponding nodes will be updated, so please keep your ComfyUI up to date.
Please note that you need to distinguish between the nightly version and the release version. In some cases, the latest release version may not be updated in time compared to the nightly version. Since we are still iterating quickly, please ensure you are using the latest version when you cannot find the corresponding node.
API access requires that your current request is based on a secure network environment. The current requirements for API access are as follows:
  • The local network only allows access from 127.0.0.1 or localhost, which may mean that you cannot use the Partner Nodes in a ComfyUI service started with the --listen parameter in a LAN environment.
  • Able to access our API service normally (a proxy service may be required in some regions).
  • Your account does not have enough credits.
  • Currently, only 127.0.0.1 or localhost access is supported.
  • Ensure your account has enough credits.
Partner Nodes require credits for API calls to closed-source models, so they do not support free usage.
Please refer to the following documentation:
  1. Comfy Account: Find the User section in the settings menu to log in.
  2. Credits: After logging in, the settings interface will show the credits menu. You can purchase credits in Settings → Credits. We use a prepaid system, so there will be no unexpected charges.
  3. Complete the payment through Stripe.
  4. Check if the credits have been updated. If not, try restarting or refreshing the page.
Currently, we do not support refunds for credits. If you believe there is an error resulting in unused balance due to technical issues, please contact support.
Credits are not intended to be used as a negative balance or credit line. However, due to race conditions where partner nodes don’t always report costs before execution, a single execution may consume more credits than your remaining balance and temporarily result in a negative balance after completion. When your balance is negative, you will not be able to run Partner Nodes until you top up and restore a positive balance. Please ensure you have enough credits before making API calls.
Please visit the Credits menu after logging in to check the corresponding credits.
Currently, the Partner Nodes are still in the testing phase and do not support this feature yet, but we have considered adding it.
Yes, the expiration depends on the type of credits:
  • Monthly credits: Expire at the end of your billing period
  • Top-up credits: Expire 1 year from the date of purchase
No, your credits cannot be transferred to other users and are limited to the currently logged-in account, but we do not restrict the number of devices that can log in.
We do not limit the number of devices that can log in; you can use your account anywhere you want.
Email a request to support@comfy.org and we will delete your information