Open WebUI với UberLLM: mọi mô hình từ một kết nối

Các bước (cài đặt hiện có)

1. Tạo một khóa trên [trang khóa của bạn]](https://uberllm.dev/dashboard/keys) và nạp tiền.
2. Đăng nhập vào Open WebUI với tư cách quản trị viên và đi đến Settings › Admin › Connections.
3. Trong mục Manage OpenAI API Connections, nhấp vào + Add Connection.
4. Điền vào:
   • Connection Type: Bên ngoài
   • URL: https://api.uberllm.dev/v1
   • Auth: Bearer
   • API Key: khóa ull_… của bạn
   • API Type: Chat Completions
5. Nhấp vào Verify Connection, sau đó Save.
6. Mở một cuộc trò chuyện mới. Bộ chọn mô hình hiện liệt kê các mô hình của UberLLM.

Các bước (cài đặt Docker mới)

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.uberllm.dev/v1 \
  -e OPENAI_API_KEY=ull_your_key \
  -v open-webui:/app/backend/data \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Các biến này chỉ áp dụng cho lần đầu tiên Open WebUI khởi động. Sau đó, giá trị được lưu trong cơ sở dữ liệu của nó sẽ được ưu tiên, vì vậy trên một cài đặt đã chạy, hãy sử dụng màn hình ở trên (hoặc khởi động nó một lần với RESET_CONFIG_ON_START=true).

Để giữ kết nối OpenAI hiện tại của bạn và thêm UberLLM bên cạnh nó, hãy sử dụng các biến số nhiều với dấu chấm phẩy giữa các mục:

-e OPENAI_API_BASE_URLS="https://api.openai.com/v1;https://api.uberllm.dev/v1" \
-e OPENAI_API_KEYS="sk-your-openai-key;ull_your_key"

Một danh sách mô hình gọn gàng

UberLLM có hàng trăm mô hình. Hai cài đặt trong mục Nâng cao của kết nối giúp danh sách chọn ngắn gọn hơn:

• ID Mô hình: chỉ liệt kê các ID bạn muốn, ví dụ deepseek/deepseek-v4.1-flash và google/gemini-3.5-flash. Open WebUI sau đó sẽ chỉ hiển thị những ID đó.
• ID Tiền tố: một từ như uberllm được thêm vào trước mỗi tên mô hình (uberllm.deepseek/deepseek-v4.1-flash), để bạn có thể phân biệt chúng với các kết nối khác. Nó sẽ được loại bỏ trước khi yêu cầu được gửi đi.

Khắc phục sự cố

• Xác minh không thành công: kiểm tra URL kết thúc bằng /v1 mà không có gì phía sau, và khóa không có khoảng trắng.
• Danh sách mô hình tải chậm hoặc trống: Open WebUI mặc định đợi danh sách 10 giây. Thêm các ID dưới Model IDs để nó ngừng tìm nạp toàn bộ danh sách, hoặc tăng AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST.
• Đã thay đổi biến Docker nhưng không có gì xảy ra: xem ghi chú khởi động lần đầu ở trên.
• 402 tín dụng không đủ: thêm tín dụng trên trang tín dụng.
• Văn bản đến theo đợt phía sau nginx của bạn: tắt bộ đệm proxy cho Open WebUI.
• Tài liệu và tìm kiếm web: Open WebUI mặc định tạo embeddings bằng mô hình cục bộ của riêng nó, đây là điều bạn muốn; UberLLM không phục vụ embeddings.

Đọc thêm

• Trang tham khảo: tài liệu Open WebUI
• thiết lập LibreChat
• Mọi mô hình với giá trực tiếp