Vane

TokenMix를 OpenAI provider로 사용해 자체 호스팅 답변 엔진을 실행하세요.

적합한 사용자

자체 호스팅 Perplexity 스타일 답변 엔진이 필요할 때 적합합니다. 검색 결과와 모델 응답을 결합해 연구, 정보 수집, 웹 Q&A에 사용할 수 있습니다.

TokenMix 정보 준비

• Provider / type: OpenAI Compatible 또는 OpenAI
• Base URL: https://api.tokenmix.ai/v1
• API Key: TokenMix API Key
• Model: TokenMix model ID, 예: <your-model-short-id>

각 필드 의미

• Provider / type은 앱이 사용할 API 프로토콜을 결정합니다. Base URL을 입력할 수 있는 OpenAI Compatible, OpenAI, Custom OpenAI를 선택하세요.
• Base URL은 실제 API endpoint입니다. https://api.tokenmix.ai/v1을 사용하고 OpenAI 기본 endpoint나 /v1 누락을 피하세요.
• API Key는 TokenMix에서 만든 Key입니다. 공개 저장소, 스크린샷, 예제, 채팅 로그에 넣지 마세요.
• Model은 TokenMix model ID입니다. 앱 이름이 아닙니다. 앞뒤 공백이나 upstream model 이름과 혼동하지 마세요.
• Embedding은 문서 검색, 지식베이스 indexing, 유사도 검색에 필요합니다. 첫 chat test에서는 비워둬도 됩니다.

설치 또는 실행

1. README에 따라 Docker 또는 Node 방식으로 시작합니다.
2. SearXNG 같은 검색 서비스를 준비합니다.
3. 브라우저에서 Vane을 열고 settings로 이동합니다.
4. 먼저 model provider를 설정하고 그다음 search source를 설정합니다.

배포 방식 선택

• 가장 쉬운 local option: Vane과 SearXNG가 포함된 Docker Bundle.
• 이미 SearXNG가 있으면 Docker Slim을 사용하고 SEARXNG_API_URL을 설정하세요.
• one-click hosting: Sealos, RepoCloud, ClawCloud, Hostinger.
• 개발자는 Node Local. 배포 후 setup screen에서 OpenAI provider Base URL을 TokenMix로 바꾸세요.

TokenMix 설정

1. OpenAI provider를 추가합니다.
2. API Key에 TokenMix API Key를 입력합니다.
3. Base URL은 https://api.tokenmix.ai/v1입니다.
4. Chat Model은 TokenMix chat model ID입니다.
5. Embedding Model은 TokenMix embedding model ID입니다.
6. 모델 목록을 불러오지 못하면 model ID를 직접 입력합니다.

첫 테스트

“what is an OpenAI compatible API base URL”을 검색하고 출처와 함께 짧게 답하세요.

먼저 테스트를 한 번 실행하세요. 성공하면 작은 실제 workflow 또는 문서 테스트를 진행합니다. 기본 호출이 동작하기 전에는 운영 데이터를 연결하지 마세요.

첫 테스트 후 다음 단계

• 답변 품질을 판단하기 전에 search service가 결과를 반환하는지 확인하세요.
• chat model과 embedding model을 모두 설정하세요. 그렇지 않으면 summary나 relevance가 불안정할 수 있습니다.
• citation이 없으면 모델을 바꾸기 전에 search backend를 확인하세요.
• 먼저 public web research에 사용하고 내부 민감 자료 검색은 바로 연결하지 마세요.

문제 해결

• 401 / unauthorized: Key가 틀렸거나 공백이 들어갔거나 만료되었습니다.
• model not found: model ID가 틀렸거나 계정에 권한이 없습니다.
• 요청이 OpenAI로 전송됨: Base URL을 TokenMix로 바꾸지 않았거나 provider 선택이 틀렸습니다.
• 출력이 짧거나 중단됨: 한 번에 보내는 내용을 줄이거나 context가 큰 모델을 사용하세요.

실제 사용 전 체크리스트

• 운영 데이터 전에 test key, test project, sample document, manual trigger로 확인하세요.
• 앱 로그, browser Network, terminal output, TokenMix request logs에서 요청이 https://api.tokenmix.ai/v1로 가는지 확인하세요.
• 실패 메시지가 이해하기 쉽고 API Key, upstream 내부 정보, local path를 노출하지 않는지 확인하세요.
• 이메일 발송, CRM 업데이트, DB 쓰기, command 실행이 가능한 앱은 처음에는 draft-only 또는 read-only로 시작하세요.
• 동작 확인 후 team permissions, budget limits, usage rules를 설정하고 고권한 Key 공유를 피하세요.

초보자 안전 팁

처음에는 임시 프로젝트, 테스트 문서, 수동 trigger로 검증하세요. 정상 응답을 확인한 뒤 실제 저장소, 지식베이스, 운영 자동화에 연결합니다. 파일 삭제, 명령 실행, 이메일 발송, DB 변경, CRM 작업은 바로 실행하지 말고 먼저 계획만 요청하세요.