Chub / Venus 整合指南

概觀

Chub 的 Secrets 面板接受完整的 `/v1/chat/completions` URL 以及你的 API 金鑰。Check your proxy 按鈕會在你於 Prompt Structure 挑選模型之前先驗證連線。

快速設定

將以下兩個值複製到 Chub Secrets 面板中的 Reverse proxy 欄位。

URL: https://api.unorouter.ai/v1/chat/completions
金鑰: YOUR_API_KEY

請貼上以 `/v1/chat/completions` 結尾的完整 URL。Chub 要求完整路徑，請勿只貼基礎 URL。

逐步設定

1. 1
   開啟 Secrets 面板

   點選 Chub 右上角的漢堡選單，然後選擇 Secrets。

2. 2
   展開 OpenAI

   點選 OpenAI 區塊以展開。

3. 3
   捲到 Reverse proxy

   Reverse proxy 子區塊包含 URL 與 Key 欄位，以及 Check your proxy 按鈕。

4. 4
   貼上 URL 與金鑰

   URL 以 `/v1/chat/completions` 結尾，Key 為你的 UnoRouter API 金鑰。

5. 5
   點選 Check your proxy

   等待綠色確認狀態。若失敗，請重新檢查 URL 並重新貼上金鑰。

6. 6
   開啟 Configuration

   回到漢堡選單，選擇 Configuration，再選擇 Prompt Structure。

7. 7
   選擇 OpenAI 與模型

   將 API 下拉式選單設為 OpenAI，再從模型下拉式選單中選擇你要的模型。

模型下拉式選單需要通過代理檢查

Chub 只會在代理檢查通過之後，才會填入 Prompt Structure 中的模型下拉式選單。若下拉式選單是空的，請回到 Secrets → OpenAI → Reverse proxy 重新執行 Check your proxy。

疑難排解

• Check your proxy 按鈕驗證失敗。 URL 錯誤。它必須以 `/v1/chat/completions` 結尾，只有基礎 URL 無法通過。
• 模型下拉式選單是空的。 代理檢查尚未通過。請重新執行步驟 5 並等待綠色狀態。
• 回應內容為空。 Prompt Structure 選錯了 API。請開啟 Configuration → Prompt Structure，將 API 下拉式選單切換為 OpenAI。
• 401 Unauthorized。 你的 API 金鑰被輪換或輸入錯誤。請到 UnoRouter 控制台產生新金鑰，再重新貼到 Reverse proxy。
• 內容長度警告。 請在 Prompt Structure 中降低最大上下文長度，或到 UnoRouter 模型頁面挑選上下文較大的模型。
• 重新載入後代理檢查顯示通過，但訊息卻失敗。 Chub 會跨工作階段快取代理檢查狀態。請在新工作階段中按一次 Check your proxy 以強制重新檢查。