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 頁面建立的 Key |
| 模型 ID | 模型選單，或 Advanced → Model IDs | deepseek-v4-1-flash，或目錄中的任一模型 ID |
設定
新增連線
- 以管理員身分登入，開啟 Settings → Admin → Connections。
- 在 Manage OpenAI API Connections 旁點選 Add Connection（+ 按鈕）。
- 將 URL 設為
https://api.cheapaimodel.ai/v1。 - Auth 維持 Bearer，把你的 cheapaimodel Key 貼到 API Key。
- API Type 維持 Chat Completions。
- 點選 Verify Connection，再點 Save。
選擇模型
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 送出請求前會去掉這個前綴。
環境變數
全新安裝時，也可以在啟動時建立同一個連線。把兩個變數加到你啟動 Open WebUI 的指令或 Compose 檔案中：
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:mainOpen 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 與目錄不符。請修正拼寫，或清空清單改由/v1/models讀取。- 修改環境變數後沒有效果。 這兩個變數只在第一次啟動時生效。請到 Settings → Admin → Connections 修改連線。