Open WebUI

Ollama 및 모든 OpenAI 호환 API를 지원하는 자체 호스팅 AI 웹 플랫폼

소개

Open WebUI는 Docker에서 실행되는 강력한 자체 호스팅 AI 웹 플랫폼입니다. 기본적으로 로컬 Ollama 모델을 지원하며, TokenMix를 포함한 모든 OpenAI 호환 API를 추가하여 프라이빗 환경에서 Claude, GPT-5, Qwen 등의 클라우드 모델을 사용할 수 있습니다.

사전 준비

• 머신에 Docker를 설치하고 다음을 실행하세요:

  docker run -d -p 3000:8080 --name open-webui ghcr.io/open-webui/open-webui:main
  

  http://localhost:3000을 열고 첫 실행 시 관리자 계정을 만드세요.
• tokenmix.ai에서 계정을 만들고 콘솔 → API Keys에서 sk-tm-으로 시작하는 API 키를 발급받으세요.

설정 단계

1. 관리자 계정으로 Open WebUI에 로그인합니다.
2. 우측 상단 아바타 클릭 → 관리자 설정.
3. Connections(연결) 탭으로 이동합니다.
4. OpenAI 섹션에서 ➕ 연결 추가 버튼을 클릭합니다.
5. 다음 정보를 입력합니다:
   • URL: https://api.tokenmix.ai/v1
   • Key: sk-tm-xxx 키 붙여넣기
6. 저장을 클릭합니다.

중요: Open WebUI는 /models 엔드포인트를 통해 모델을 자동으로 검색합니다. TokenMix는 사용 가능한 모든 모델을 반환하므로 목록이 자동으로 채워집니다. 특정 모델이 표시되지 않으면 7단계로 진행하세요.

7. (선택) 연결 설정에서 Model IDs (Filter) 필드에 사용할 모델 ID를 직접 입력하세요(예: claude-sonnet-4.6, gpt-5.4, qwen3.6-max-preview). 다시 저장합니다.

확인

메인 채팅 화면으로 돌아가 채팅 창 상단의 모델 선택 드롭다운을 클릭하세요. TokenMix 모델 목록이 표시되면 성공입니다. 대화를 시작하여 정상 작동을 확인하세요.

자주 묻는 질문

Q: 연결을 저장했는데 모델이 표시되지 않습니다. A: Open WebUI는 /v1/models 엔드포인트로 모델을 열거합니다. 목록이 비어 있으면 Model IDs (Filter) 필드에 사용할 모델 short_id를 직접 지정하세요(예: claude-sonnet-4.6, gpt-5.4, qwen3.6-max-preview).

Q: 401 Unauthorized 오류가 발생합니다. A: URL이 정확히 https://api.tokenmix.ai/v1인지 확인하세요(/v1 포함, 끝에 슬래시 없음). TokenMix 콘솔에서 키를 다시 붙여넣으세요.

Q: 팀 여러 명이 Open WebUI를 사용하려면 어떻게 하나요? A: Open WebUI에는 완전한 사용자 관리 시스템이 내장되어 있습니다. 관리자 설정 → 사용자에서 팀원을 초대하고 역할을 지정하세요. TokenMix 연결은 관리자가 일괄 설정하며 모든 사용자가 공유합니다.