공급자 키

공급자 키는 셀프 호스팅 Nodaro가 AI 모델을 호출할 수 있게 해 주는 API 키입니다. 앱에 붙여 넣거나 환경 변수로 설정할 수 있으며, 두 방법을 동시에 쓸 수 있습니다. 키 대신, 또는 키와 함께 설치를 Nodaro Cloud 계정에 연결할 수도 있습니다. Nodaro Cloud에 연결을 참조하세요.

키를 추가하는 두 가지 방법

키를 붙여 넣은 직후의 실행도 작동합니다. 공급자를 찾지 못한 노드는 실패하기 전에 키를 한 번 다시 읽습니다.

키를 붙여 넣으려면 항상 앱에 로그인한 세션이 필요합니다. API 토큰이나 앱 토큰으로는 키를 절대 바꿀 수 없습니다. /setup의 상태 카드는 로그인 없이 볼 수 있지만, 그곳에서 키를 저장하려면 로그인해야 합니다. 먼저 1단계 서버 로그인 계정 만들기를 완료하세요.

우선하는 키

환경 변수가 우선합니다. 환경 변수로 설정한 키는 화면에서 읽기 전용입니다. 그 타일에는 set (env)(환경 변수에서 설정됨)이 표시되고, 제거해야 할 변수 이름이 나옵니다. 붙여 넣은 키는 해당 공급자의 키가 환경 변수에 없을 때만 쓰입니다.

타일에서 키 관리

.env에서 온 키를 포함해 모든 공급자 타일은 실행 중에 관리할 수 있습니다. 변경 사항은 재시작 없이 적용됩니다.

• 붙여 넣은 키에는 set (app)(앱에서 설정됨)이 표시되고, nodaro.ai 타일에는 key set (app)이 표시됩니다. 언제든지 키 변경 또는 제거를 클릭하세요.
• .env의 키는 그 자리에서 편집할 수 없습니다. .env 키 교체는 파일을 편집하지 않고, 환경 변수의 키보다 우선하는 키를 앱에 저장합니다. 또는 .env에서 키를 제거하고 재시작하세요.
• 비활성화는 다시 활성화할 때까지 공급자를 멈춥니다. 키가 .env에서 왔든 붙여 넣은 것이든 마찬가지입니다. 예를 들어 생성을 Nodaro Cloud 연결 같은 다른 공급자로 옮길 때 쓰세요.
• 누락됨은 공급자에 키가 없다는 뜻입니다. 비활성화됨은 내가 공급자를 껐다는 뜻입니다.

각 타일에는 그 키로 실행되는 기능과 키를 받는 곳이 나와 있습니다.

모든 공급자 키

특정 노드에서 쓰는 키

해당 노드를 쓰지 않는다면 비워 두세요. 연결된 설치에서는 키가 비어 있을 때 이 노드들이 Nodaro Cloud를 통해 실행됩니다.

GEMINI_API_KEY는 GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET과 다릅니다. 이 두 값은 YouTube 게시 등에 쓰는 Google OAuth 앱의 값입니다. 소셜 네트워크 앱을 참조하세요.

키와 Nodaro Cloud 연결

• 연결 하나로 모든 타일이 해결됩니다. 연결된 설치에서는 이미지, 동영상, 음성, 텍스트 모델과 아바타, 조명 변경 및 교체, 웹 스크래핑이 내 Nodaro Cloud 계정을 통해 실행됩니다. 해당 공급자를 직접 호출하려는 경우에만 키를 붙여 넣으세요.
• 우선순위는 내가 정합니다. 연결할 때 대화 상자에서 Nodaro Cloud가 먼저 모든 것을 실행할지, 내 키가 먼저 실행할지 묻습니다. 연결 사용 방식 선택을 참조하세요.
• OAuth 연결이 NODARO_API_KEY보다 우선합니다. 설치에 둘 다 있으면 연결을 쓰고 키는 무시합니다.

Gemini 모델

Gemini 모델은 두 가지 방식으로 실행할 수 있습니다. GEMINI_API_KEY가 없으면 KIE_API_KEY로 실행됩니다. 이 키가 있으면 다음과 같습니다.

• Gemini 3.1 Pro는 먼저 Google에서 직접 실행되고, KIE_API_KEY가 대체 경로가 됩니다.
• Gemini Flash 모델은 KIE_API_KEY에 그대로 머물고, 그것이 실패할 때만 GEMINI_API_KEY를 씁니다.

설정하기 전에 알아 둘 점이 두 가지 있습니다.

• 비용. Google은 직접 경로를 자체 토큰당 가격으로 청구하며, 같은 모델을 KIE_API_KEY로 쓸 때보다 비쌀 수 있습니다. 사용량이 많은 모델을 옮기기 전에 Google의 현재 가격을 확인하세요.
• 미디어. Google의 API는 임의의 URL을 가져올 수 없습니다. Nodaro는 각 이미지, 동영상, 오디오 레퍼런스를 내려받아, 작으면 인라인 데이터로, 크면 Gemini Files API로 보냅니다. Files API는 파일을 48시간 동안 보관합니다.

내 프록시로 공급자 트래픽 보내기

두 공급자는 키뿐 아니라 호스트도 바꿀 수 있습니다.

둘 다 설정하지 않으면 아무것도 바뀌지 않습니다. 하나를 설정하면 Nodaro는 대신 내 호스트와 통신합니다. 흔한 이유는 실제 키를 프록시에만 두는 키 보관, 모든 외부 생성 요청의 감사 로그, 지역별 라우팅입니다.

프록시는 투명해야 합니다. Nodaro는 출처만 바꾸므로 경로, 요청 본문, 응답 본문이 같아야 합니다. 끝의 슬래시는 제거되므로 https://proxy.example.com/models/와 https://proxy.example.com/models는 똑같이 동작합니다.

ANTHROPIC_API_KEY와 GEMINI_API_KEY는 프록시의 영향을 받지 않습니다. 이 키를 쓰면 해당 모델은 Anthropic과 Google을 직접 호출합니다.

키 작동 확인

• 편집기에서. Welcome Demo를 열고 장면 이미지 노드에서 실행을 클릭하세요.
• 명령줄에서. --keyed로 프로브를 실행하세요. KIE_API_KEY 또는 REPLICATE_API_TOKEN에 맞는 가장 저렴한 모델로 실제 생성을 한 번 하고, 미디어가 내 스토리지에 저장되는지 확인합니다.

node tools/community-smoke.mjs http://localhost:3000 --keyed

Missing API key로 실패하는 노드는 키가 없는 공급자를 호출하고 있습니다. /setup이나 .env에 그 공급자의 키를 추가하세요.

암호화 키

붙여 넣은 키에는 인스턴스 암호화 키 NODARO_ENCRYPTION_KEY가 필요합니다. 번들된 Compose 스택은 첫 부팅 때 이 키를 생성합니다. 키가 없으면 타일에 누락됨이 표시되고, /setup에 해결 방법과 함께 빨간색 암호화 카드가 나타납니다. 환경 변수로 설정한 키는 계속 작동합니다. 설치를 참조하세요.