프로바이더 프로필과 API 키
이름 있는 프로바이더 프로필과 API 인증, 로컬·원격 실행 방식, 모델 슬롯, 벤더별 기본값을 설정합니다.
프로필은 하나의 실행 정체성입니다
Settings → 프로바이더를 엽니다. 프로바이더 프로필은 어떤 벤더나 런타임을 실제로 실행하는 한 가지 방법에 이름을 붙입니다. API 키, Application Default Credentials, 로컬 서비스, GCP IAP 터널, 원격 GPU controller가 각각 다른 프로필이 될 수 있습니다.
같은 벤더에 여러 프로필을 둘 수 있지만 실제 기본값은 하나입니다. 저장된 Flow는 카탈로그의 Variant와 호환 프로필을 실행 시점에 사용하며, 비밀키 자체를 그래프에 저장하지 않습니다.
프로필 만들고 확인하기
- 벤더 또는 서비스를 선택합니다.
- + 프로필을 누르고 알아보기 쉬운 이름을 붙입니다.
- 서버가 제공하는 인증·실행 방식 중 하나를 고릅니다.
- 그 방식이 요구하는 항목만 입력합니다.
- 설정 저장을 누릅니다.
- 이 프로필을 벤더 기본값으로 쓸 경우 기본 프로필로 설정을 누릅니다.
- 재확인을 누르고 상태를 읽은 뒤 유료 Variant를 선택합니다.
인증 방식을 바꾸면 실행 계약도 바뀝니다. 예를 들어 Google API key와 Application Default Credentials는 서로 다른 경로입니다. AI Studio 키가 동작해도 Vertex AI 준비가 끝났다는 뜻은 아닙니다. 두 방식을 병행하려면 기존 프로필의 방식을 바꾸기보다 별도 프로필을 만드는 편이 안전합니다. 인증 방식을 전환하면 그 프로필의 이전 키와 설정은 정리됩니다.
비밀 정보가 저장되는 곳
API 키와 controller 인증 정보는 서버 컴퓨터 운영체제의 자격 증명 저장소에 기록됩니다. 브라우저에는 전체 값이 아니라 마스킹된 상태와 끝부분만 전달됩니다. 프로필에 저장한 키는 같은 벤더의 환경 변수보다 우선합니다.
인증 정보는 선언된 Settings 입력란이나 승인된 설치 터미널에만 입력하세요. Hugging Face 토큰, Google 인증 정보, Runpod 키, controller secret을 Canvas, 프롬프트, 에이전트 채팅에 붙여넣지 마세요.
Kumiho Desktop 설치판에서 가져온 프로필은 설치판 프로필로 표시되고 읽기 전용일 수 있습니다. 여기서 선택해 쓸 수는 있지만 자격 증명과 연결 정보는 원본 설치판에서 바꿔야 합니다. 설치판 GCP controller가 실제 기본값일 때 로컬 프로필 편집이 잠길 수도 있습니다.
현재 프로바이더 계열
서버 카탈로그에는 현재 다음과 같은 계열의 프로필이 포함됩니다.
| 계열 | 일반적인 실행 방식 |
|---|---|
| Google · Gemini / Veo | API 키 또는 ADC를 통한 Vertex AI |
| OpenAI · GPT Image | 프로바이더 API 키 |
| BytePlus Ark · Seedance | 프로바이더 API 키 |
| Alibaba Cloud Model Studio · Wan | 프로바이더 API 키 |
| Kling AI | 프로바이더 API 키 |
| Black Forest Labs · FLUX | 프로바이더 API 키 |
| Topaz Labs | 프로바이더 API 키 |
| ElevenLabs | 음성·효과음·음악 API 키 |
| MiniMax API | H3 영상과 지원되는 MiniMax API 기능 |
| ComfyUI service | 로컬 엔드포인트, GCP IAP, 관리형 원격 controller, Runpod |
이 표는 길잡이이지 영구적인 호환성 약속이 아닙니다. Settings는 실행 중인 서버의 기능 카탈로그로 그려지고, 선택한 Canvas Variant가 허용하는 프로필 방식을 선언합니다.
ComfyUI 프로필과 모델 슬롯
ComfyUI 프로필은 내장 로컬 inference service, 로컬 또는 신뢰할 수 있는 네트워크의 endpoint, IAP로 연결한 비공개 GCP VM, on-demand controller, Runpod controller를 가리킬 수 있습니다. 같은 ComfyUI Variant를 호환되는 다른 실행 방식으로 옮겨도 Flow에 인증 정보를 넣을 필요가 없습니다.
한 ComfyUI에서 여러 모델 계열을 쓸 수 있습니다. 서비스가 연결되면 Settings는 그 인스턴스가 각 모델 슬롯에 실제로 적재할 수 있는 파일을 물어보고, 임의의 파일명을 받는 대신 선택지를 보여 줍니다. 모델 계열마다 파일을 따로 연결하고 누락된 슬롯을 모두 해결한 뒤 생성하세요.
내장 설치 도구를 열기 전 ComfyUI와 GPU 설정을 읽어 보세요. ComfyUI 원본에는 자체 인증이 없으므로 직접 사용하는 :8188은 loopback 또는 신뢰할 수 있는 네트워크에만 두어야 합니다.
상태 문구를 읽는 법
- 설정됨은 선택한 방식에 필요한 인증 또는 설정 surface가 존재한다는 뜻입니다. ADC에서는 주변 자격 증명일 수 있고 endpoint 방식에서는 저장된 URL일 수 있습니다. 연결 가능 상태나 모델 실행 성공을 보장하지는 않습니다.
- 확인 중이 계속되면 재확인으로 해당 인증 surface를 다시 확인합니다.
- 로컬 서비스가 잠시 연결되지 않아도 저장된 프로필은 복구를 위해 남을 수 있습니다.
- 인증이 성공해도 모델·리전·계정 권한 때문에 실행이 거절될 수 있습니다.
- 유료 프로바이더 호출은 그래프 검증과 비용 승인 단계를 그대로 거칩니다.
Google Cloud 프로젝트 인증은 Google Cloud ADC와 Vertex AI에서 이어집니다. Variant, Run, Take의 뜻은 제작 기록과 용어를 참고하세요.