Open WebUI

Chat với các mô hình cheapaimodel trong Open WebUI qua một kết nối OpenAI API.

Open WebUI kết nối với các dịch vụ tương thích OpenAI qua các kết nối OpenAI API, do admin thêm trong Settings → Admin → Connections. Khi kết nối đã được lưu, các mô hình từ kết nối đó xuất hiện trong bộ chọn mô hình của mọi người dùng.

	Cài đặt Open WebUI	Giá trị
Base URL	URL	`https://api.cheapaimodel.ai/v1`
API key	API Key (với Auth để Bearer)	Key của bạn từ trang API key trong bảng điều khiển
ID mô hình	Bộ chọn mô hình, hoặc Advanced → Model IDs	`deepseek-v4-1-flash`, hoặc bất kỳ ID nào trong danh mục

Thiết lập

Thêm kết nối

Đăng nhập bằng tài khoản admin, mở Settings → Admin → Connections.
Bên cạnh Manage OpenAI API Connections, nhấn Add Connection (nút +).
Đặt URL thành https://api.cheapaimodel.ai/v1.
Để Auth ở Bearer và dán key cheapaimodel của bạn vào API Key.
Để API Type ở Chat Completions.
Nhấn Verify Connection, rồi Save.

Chọn mô hình

Open WebUI đọc danh sách mô hình từ /v1/models, nơi trả về các mô hình mà key của bạn được dùng. Chọn deepseek-v4-1-flash trong bộ chọn mô hình và bắt đầu chat.

Muốn chỉ hiện một vài mô hình, hãy thêm ID của chúng vào Advanced → Model IDs; khi đó Open WebUI chỉ liệt kê đúng các mô hình đó và không tự lấy danh sách nữa. Nếu một kết nối khác cũng phục vụ cùng ID, đặt Prefix ID, ví dụ cheapaimodel: mô hình sẽ hiện là cheapaimodel.deepseek-v4-1-flash, và Open WebUI bỏ tiền tố trước khi gửi yêu cầu.

Biến môi trường

Với bản cài mới, bạn có thể tạo sẵn kết nối này lúc khởi động. Thêm hai biến vào lệnh hoặc tệp Compose mà bạn dùng để chạy Open WebUI:

Terminal

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e OPENAI_API_BASE_URL="https://api.cheapaimodel.ai/v1" \
  -e OPENAI_API_KEY="$CHEAPAIMODEL_API_KEY" \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Open WebUI chỉ đọc các biến này ở lần khởi động đầu tiên, sau đó lưu giá trị trong cơ sở dữ liệu. Muốn đổi kết nối về sau, vào Settings → Admin → Connections.

Tài liệu và kiến thức

cheapaimodel chưa có mô hình embeddings. Trong Settings → Admin → Documents, để embedding engine dùng mô hình có sẵn của Open WebUI hoặc một nhà cung cấp khác; đừng trỏ sang cheapaimodel. Image :slim không có mô hình embedding có sẵn, nên muốn dùng RAG trên image đó bạn cần embeddings của nhà cung cấp khác.

Lỗi thường gặp

Verify Connection báo lỗi 404 kèm fault filter abort, và không có mô hình nào hiện ra. URL thiếu /v1. Đặt thành https://api.cheapaimodel.ai/v1.
Mọi tin nhắn đều báo lỗi 404 kèm Invalid URL (POST /v1/chat/completions/chat/completions). URL có kèm đường dẫn endpoint. Open WebUI tự thêm đường dẫn; đặt thành https://api.cheapaimodel.ai/v1.
401. Key sai, đã hết hạn hoặc đã dùng hết hạn mức chi tiêu, hoặc Auth không phải Bearer. Kiểm tra key trong bảng điều khiển.
503 kèm model_not_found. Một ID nhập trong Model IDs không khớp với danh mục. Sửa lại chính tả, hoặc xóa danh sách đó để lấy danh sách từ /v1/models.
Đổi biến môi trường nhưng không có tác dụng. Các biến này chỉ áp dụng ở lần khởi động đầu tiên. Sửa kết nối trong Settings → Admin → Connections.