BYOK(Bring Your Own Key)는 셀프 호스팅의 핵심 메커니즘입니다: 키는 당신 머신의 api/.env에만 존재하며, 선택한 게이트웨이로의 외부 호출에만 사용됩니다 — 중간 서버를 거치지 않습니다.
게이트웨이 고르는 법
틀린 답은 없습니다. 모두 같은 OpenAI 프로토콜입니다: OpenRouter는 국제 사용자에게 적합(키 하나로 100+ 모델, 무료 티어 있음), Groq는 추론이 가장 빠르고 무료 한도가 넉넉, DeepSeek는 가장 저렴한 유료 옵션이며 중국어에 강함, Together는 오픈 웨이트 대형 모델 제공, OpenAI 공식은 이미 키가 있는 사람에게 적합, Ollama는 완전 로컬·오프라인에 API 비용 제로(VRAM 8GB 이상 권장 — llama3.1:8b / qwen2.5:7b급이면 쓸 만한 경험). 모르겠으면 무료 티어부터 시작하세요. 나중에 env 두 줄만 바꾸면 언제든 갈아탈 수 있습니다.
연결과 전환
api/.env에 세 줄을 채웁니다: DEEPSEEK_API_KEY(범용 게이트웨이 키 슬롯 — 역사적 명명), OPENAI_BASE_URL, AI_MODEL. 게이트웨이 전환 = 중지 → 이 세 줄 변경 → 재시작. 채팅 기록과 AI 주민의 관계 데이터는 모델에 독립적입니다 — 무료 8B 모델에서 플래그십 모델로 올라가도 메시지 하나 잃지 않습니다.
월드 오너 전용 키
인스턴스 기본 게이트웨이 외에, 월드 오너는 앱의 개인 설정에서 자신의 API 키와 선택적 Base URL을 설정할 수 있습니다: 설정하면 월드 오너의 요청만 그 키를 사용하고, 지우면 즉시 인스턴스 기본값으로 돌아갑니다. 키는 서버 측에 암호화된 암호문으로만 저장되며(암호화 키는 env의 USER_API_KEY_ENCRYPTION_SECRET), 어떤 조회 엔드포인트도 평문을 반환하지 않습니다.
한도를 다 쓰면 어떻게 되나
게이트웨이 오류는 정직하게 그대로 전달됩니다: AI 주민은 크래시 대신 "지금 머리가 잘 안 돌아간다"는 식으로 반응합니다. 게이트웨이를 충전하거나 다른 게이트웨이로 바꾸고 재시작하면 복구됩니다.
비전과 미디어
AI가 이미지를 읽게 하려면 AI_MODEL이 이미지 입력을 지원하는 모델이어야 합니다(gpt-4o-mini, claude 계열, qwen-vl-plus 등). 동영상 채널 / 음악 생성은 선택적 MiniMax 키를 사용하며 채팅 게이트웨이와 서로 독립적입니다 — 설정하지 않아도 다른 기능에는 영향이 없습니다.
관련 질문
Enclave는 어떤 대형 언어 모델을 지원하나요?
Enclave의 모델 계층은 완전히 교체 가능합니다. OpenAI, Anthropic, Google, DeepSeek는 물론 로컬 Ollama / vLLM도 모두 구성할 수 있습니다. 캐릭터마다 다른 모델을 사용할 수도 있어 상황과 비용에 따라 자유롭게 배분합니다.Enclave를 완전히 오프라인으로 실행할 수 있나요?
가능합니다. 모델 계층을 로컬 Ollama / vLLM으로 교체하고 현실 세계 동기화를 끄면, 시스템 전체가 외부로 어떤 요청도 보내지 않고 당신의 기기에서 완전히 오프라인으로 작동합니다 — 어떤 약속에도 의존하지 않는 가장 강력한 프라이버시 보장입니다.제 대화 데이터는 안전한가요? 학습에 사용되나요?
셀프 호스팅 모드에서는 당신의 대화가 본인의 디스크에만 저장되어 기기를 벗어나지 않으며 어떤 제3자의 학습에도 사용되지 않습니다. 모델 계층은 OpenAI, Anthropic 등의 클라우드 API에 연결할 수 있고, 로컬 Ollama / vLLM으로 교체해 완전 오프라인으로 실행할 수도 있습니다. 어떤 대화를 어느 모델로 보낼지는 당신이 결정합니다.Enclave는 무료인가요? 요금은 어떻게 되나요?
Enclave는 무료로 시작할 수 있습니다. 브라우저에서 바로 사용하며 신용카드가 필요 없습니다. 일상적인 사용은 멤버십 구독으로 커버되고, PPT / 동영상 생성 같은 일부 고소비 동작은 지갑 종량제로 과금됩니다. 코드 자체가 MIT 오픈소스이므로 셀프 호스팅은 완전 무료이며, 직접 연결한 모델의 API 비용만 부담합니다.