Open WebUI
Open WebUI thêm UberLLM như một kết nối OpenAI API.
Trước khi bắt đầu
- Một tài khoản UberLLM có số dư, và một API key từ
Dashboard → Khóa](
ull_...).
Thiết lập (kết nối quản trị viên, cho mọi người trên máy chủ)
- Vào Cài đặt → Quản trị → Kết nối.
- Trong mục Quản lý Kết nối API OpenAI, nhấp vào ➕ Thêm Kết nối.
- Điền thông tin:
- URL:
https://api.uberllm.dev/v1 - API Key: khóa
ull_...của bạn (để loại xác thực là Bearer)
- URL:
- Mở Nâng cao (tùy chọn nhưng được khuyến nghị):
- Prefix ID:
uberllm. Các mô hình sau đó hiển thị dưới dạnguberllm.z-ai/glm-5.2, để chúng không bao giờ xung đột với các mô hình từ các kết nối khác của bạn. Open WebUI sẽ xóa tiền tố trước khi gửi yêu cầu. - Model IDs: thêm các mô hình bạn muốn, từng cái một bằng + (xem bên dưới). Khi danh sách này được đặt, Open WebUI chỉ hiển thị các mô hình này và ngừng tải toàn bộ danh sách.
- Headers:
{"X-Title": "Open WebUI"}cho UberLLM biết ứng dụng nào đã gửi yêu cầu.
- Prefix ID:
- Để API Type là Chat Completions, cài đặt được thử nghiệm ở đây. UberLLM cũng cung cấp API Phản hồi.
- Nhấp vào Xác minh Kết nối, sau đó Lưu. Chỉ lưu không kiểm tra bất cứ điều gì.
UberLLM liệt kê khoảng 450 mô hình, bao gồm các mô hình hình ảnh và video không trò chuyện được. Nếu không có danh sách Model IDs, mỗi mô hình trong số đó sẽ xuất hiện trong menu và mỗi lần tải trang sẽ phải chờ toàn bộ danh sách, vì vậy hãy thêm một danh sách cho phép (hoặc bật Cache Base Model List).
Thiết lập với biến môi trường 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
Các biến này chỉ được đọc khi khởi động lần đầu. Sau đó, giá trị được lưu trong cơ sở dữ liệu của Open WebUI sẽ được ưu tiên, trừ khi bạn đặt ENABLE_PERSISTENT_CONFIG=False. Nếu bạn đã chạy Open WebUI, hãy sử dụng màn hình quản trị thay thế.
Kết nối trực tiếp (mỗi người dùng tự mang khóa của mình)
- Quản trị viên bật Kết nối trực tiếp trong mục Settings → Admin → Connections
(hoặc đặt
ENABLE_DIRECT_CONNECTIONS=true). - Mỗi người dùng mở User Settings → Connections, nhấp vào +, và nhập
Base URL
https://api.uberllm.dev/v1và API Key của riêng họ.
Với kết nối trực tiếp, trình duyệt của người dùng gọi trực tiếp UberLLM và khóa vẫn nằm trong trình duyệt đó. UberLLM cho phép các cuộc gọi trình duyệt này.
Các mô hình được đề xuất
Đã kiểm tra vào 30 tháng 10, 2026 thông qua UberLLM.
| ID mô hình | Ngữ cảnh | Ghi chú |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | Nhanh; lý giải trước khi trả lời |
google/gemini-2.5-flash |
1,048,576 | Đọc hình ảnh |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | Đọc hình ảnh, trả lời mà không cần bước lý giải |
Các lỗi thường gặp
| Bạn thấy gì | Nguyên nhân và cách khắc phục |
|---|---|
Verify Connection thất bại với 401 |
API key bị thiếu hoặc gõ sai. |
| Không có mô hình nào xuất hiện | URL có dấu gạch chéo ở cuối hoặc bị lỗi chính tả. Nó phải chính xác là https://api.uberllm.dev/v1. |
| Menu mô hình hoặc trang tải chậm | Không có danh sách cho phép Model IDs: xem ở trên. |
| Một mô hình từ kết nối khác biến mất | Hai kết nối trả về cùng một id mà không có tiền tố, và Open WebUI đã giữ lại một. Đặt Prefix ID. |
402 insufficient_credits |
Số dư trống. Thêm tín dụng trong Dashboard → Credits. |