# Open WebUI (/vi/docs/guides/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](https://console.cheapaimodel.ai/keys) 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](/vi/models)                     |

## Thiết lập [#set-it-up]

<Steps>
  <Step>
    ### Thêm kết nối [#add-the-connection]

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

  <Step>
    ### Chọn mô hình [#pick-a-model]

    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.
  </Step>
</Steps>

## Biến môi trường [#environment-variables]

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:

```bash title="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 [#documents-and-knowledge]

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 [#common-mistakes]

* **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](/vi/models). 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**.