Open WebUI
Open WebUI는 UberLLM을 OpenAI API 연결로 추가합니다.
시작하기 전에
- 크레딧이 있는 UberLLM 계정, 그리고 대시보드 → 키](
ull_...)에서 발급받은 API 키.
설정 (관리자 연결, 서버의 모든 사용자를 위한)
- 설정 → 관리자 → 연결로 이동합니다.
- OpenAI API 연결 관리 아래에서 ➕ 연결 추가를 클릭합니다.
- 다음을 입력합니다:
- URL:
https://api.uberllm.dev/v1 - API Key: 사용자
ull_...키 (인증 유형은 Bearer로 둡니다)
- URL:
- 고급을 엽니다 (선택 사항이지만 권장됨):
- Prefix ID:
uberllm. 모델은uberllm.z-ai/glm-5.2으로 표시되므로 다른 연결의 모델과 충돌하지 않습니다. Open WebUI는 요청을 보내기 전에 접두사를 제거합니다. - Model IDs: 원하는 모델을 **+**를 사용하여 한 번에 하나씩 추가합니다 (아래 참조). 이 목록이 설정되면 Open WebUI는 이 모델만 표시하고 전체 목록 로드를 중지합니다.
- Headers:
{"X-Title": "Open WebUI"}는 UberLLM에 어떤 앱이 요청을 보냈는지 알려줍니다.
- Prefix ID:
- API 유형을 Chat Completions로 둡니다. 여기에서 테스트된 설정입니다. UberLLM은 Responses API도 제공합니다.
- 연결 확인을 클릭한 다음 저장합니다. 저장만으로는 아무것도 테스트되지 않습니다.
UberLLM은 채팅하지 않는 이미지 및 비디오 모델을 포함하여 450개 정도의 모델을 나열합니다. 모델 ID 목록이 없으면 모든 모델이 메뉴에 나타나고 각 페이지 로드는 전체 목록을 기다리므로 허용 목록을 추가하거나 (기본 모델 목록 캐시를 십시오).
Docker 환경 변수로 설정
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URLS="https://api.uberllm.dev/v1" \
-e OPENAI_API_KEYS="ull_your-key" \
-e OPENAI_API_CONFIGS='{"0":{"prefix_id":"uberllm","model_ids":["deepseek/deepseek-v4.1-flash","google/gemini-2.5-flash","z-ai/glm-5.2"]}}' \
-v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
이 변수들은 첫 시작 시에만 읽힙니다. 그 이후에는 ENABLE_PERSISTENT_CONFIG=False을(를) 설정하지 않는 한, Open WebUI 데이터베이스에 저장된 값이 우선합니다. 이미 Open WebUI를 실행 중이라면, 대신 관리자 화면을 사용하세요.
직접 연결 (각 사용자가 본인의 키를 가져옴)
- 관리자가 Settings → Admin → Connections에서 직접 연결을 웁니다 (또는
ENABLE_DIRECT_CONNECTIONS=true으로 설정합니다). - 각 사용자는 User Settings → Connections를 열고, **+**를 클릭한 다음, Base URL
https://api.uberllm.dev/v1과 본인의 API Key를 입력합니다.
직접 연결을 사용하면 사용자의 브라우저가 UberLLM 자체를 호출하고 키는 해당 브라우저에 유지됩니다. UberLLM은 이러한 브라우저 호출을 허용합니다.
추천 모델
UberLLM에서 2026년 10월 30일에 확인되었습니다.
| 모델 ID | 컨텍스트 | 참고 |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | 빠름; 답변 전에 추론 과정을 보여줌 |
google/gemini-2.5-flash |
1,048,576 | 이미지 읽기 가능 |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | 이미지 읽기 가능, 추론 과정 없이 바로 답변 |
자주 발생하는 오류
| 문제 현상 | 원인 및 해결 방법 |
|---|---|
Verify Connection이 401 오류와 함께 실패합니다 |
키가 없거나 잘못 입력되었습니다. |
| 모델이 표시되지 않습니다 | URL에 후행 슬래시가 있거나 오타가 있습니다. 정확히 https://api.uberllm.dev/v1이어야 합니다. |
| 모델 메뉴 또는 페이지 로딩이 느립니다 | Model IDs 허용 목록이 없습니다: 위를 참조하세요. |
| 다른 연결의 모델이 사라졌습니다 | 두 연결이 접두사 없이 동일한 id를 반환했고, Open WebUI가 하나만 유지했습니다. Prefix ID를 설정하세요. |
402 insufficient_credits |
잔액이 부족합니다. 대시보드 → 크레딧에서 크레딧을 추가하세요. |