# Open WebUI (/zh-Hant/docs/guides/open-webui)

透過 OpenAI API 連線，在 Open WebUI 中與 cheapaimodel 的模型對話。



Open WebUI 透過 **OpenAI API** 連線接上 OpenAI 相容的服務，由管理員在 **Settings → Admin → Connections** 新增。連線儲存後，它的模型會出現在每位使用者的模型選單中。

|          | Open WebUI 設定                       | 值                                                               |
| -------- | ----------------------------------- | --------------------------------------------------------------- |
| Base URL | **URL**                             | `https://api.cheapaimodel.ai/v1`                                |
| API Key  | **API Key**（**Auth** 維持 **Bearer**） | 在控制台的 [API Key](https://console.cheapaimodel.ai/keys) 頁面建立的 Key |
| 模型 ID    | 模型選單，或 **Advanced → Model IDs**     | `deepseek-v4-1-flash`，或[目錄](/zh-Hant/models)中的任一模型 ID           |

## 設定 [#設定]

<Steps>
  <Step>
    ### 新增連線 [#新增連線]

    1. 以管理員身分登入，開啟 **Settings → Admin → Connections**。
    2. 在 **Manage OpenAI API Connections** 旁點選 **Add Connection*&#x2A;（&#x2A;*+** 按鈕）。
    3. 將 **URL** 設為 `https://api.cheapaimodel.ai/v1`。
    4. **Auth** 維持 **Bearer**，把你的 cheapaimodel Key 貼到 **API Key**。
    5. **API Type** 維持 **Chat Completions**。
    6. 點選 **Verify Connection**，再點 **Save**。
  </Step>

  <Step>
    ### 選擇模型 [#選擇模型]

    Open WebUI 從 `/v1/models` 讀取模型清單，回傳的是你的 Key 可用的模型。在模型選單中選擇 `deepseek-v4-1-flash` 即可開始對話。

    若只想提供部分模型，請在 **Advanced → Model IDs** 加入它們的 ID；Open WebUI 之後只列出這些模型，不再讀取清單。若另一個連線也提供相同的 ID，請設定 **Prefix ID**，例如 `cheapaimodel`：模型會顯示為 `cheapaimodel.deepseek-v4-1-flash`，Open WebUI 送出請求前會去掉這個前綴。
  </Step>
</Steps>

## 環境變數 [#環境變數]

全新安裝時，也可以在啟動時建立同一個連線。把兩個變數加到你啟動 Open WebUI 的指令或 Compose 檔案中：

```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 只在第一次啟動時讀取這兩個變數，之後把值存在自己的資料庫中。日後要修改連線，請到 **Settings → Admin → Connections**。

## 文件與知識庫 [#文件與知識庫]

cheapaimodel 目前沒有 embedding 模型。**Settings → Admin → Documents** 的 embedding 引擎請維持 Open WebUI 內建的模型或改用其他供應商，不要指向 cheapaimodel。`:slim` 映像檔沒有內建 embedding 模型，在其中使用 RAG 需要其他供應商的 embeddings。

## 常見錯誤 [#常見錯誤]

* **Verify Connection 以 `404` 與 `fault filter abort` 失敗，也看不到任何模型。** **URL** 漏了 `/v1`。請設定 `https://api.cheapaimodel.ai/v1`。
* **每則訊息都以 `404` 與 `Invalid URL (POST /v1/chat/completions/chat/completions)` 失敗。** **URL** 含有端點路徑。Open WebUI 會自行加上路徑；請設定 `https://api.cheapaimodel.ai/v1`。
* **`401`。** Key 錯誤、已到期或預算已用盡，或 **Auth** 不是 **Bearer**。請在控制台檢查這組 Key。
* **`503` 且 `model_not_found`。** **Model IDs** 中手動輸入的 ID 與[目錄](/zh-Hant/models)不符。請修正拼寫，或清空清單改由 `/v1/models` 讀取。
* **修改環境變數後沒有效果。** 這兩個變數只在第一次啟動時生效。請到 **Settings → Admin → Connections** 修改連線。