RisuAI 整合指南

概觀

RisuAI 的 Custom Models 欄位可讓你貼上 Request URL、API 金鑰與模型 ID。需要注意的陷阱是一個名為 Autofill Request URL 的開關：當它開啟時，RisuAI 會改寫你貼上的 URL，在沒有錯誤訊息的情況下悄悄中斷連線。

快速設定

將以下三個值複製到 RisuAI 的 Advanced Settings 中的 Custom Models 欄位。

Request URL: https://api.unorouter.ai/v1/chat/completions
API 金鑰:    YOUR_API_KEY
模型 ID:   claude-opus-4-5

請貼上以 `/v1/chat/completions` 結尾的完整 URL。RisuAI 在 Custom Models 模式下沒有模型下拉式選單，Model ID 是手動輸入的文字欄位。

逐步設定

1. 1
   開啟 Advanced Settings

   在 RisuAI 中，先開啟 Settings，再進入 Advanced Settings。

2. 2
   選擇一個模型欄位

   點選 Chat Bot 的模型選擇器，捲動到模型清單底端，選擇 Custom Models。

3. 3
   取消勾選 Autofill Request URL

   在貼上任何內容之前，這個開關必須是關閉的。請參考上方的關鍵警告。

4. 4
   貼上 Request URL

   貼上以 `/v1/chat/completions` 結尾的完整 URL。

5. 5
   貼上 API 金鑰

   將你的 UnoRouter API 金鑰貼到 API Key 欄位。部分 RisuAI 版本會把此欄位標示為 Authorization，若找不到 API Key 欄位請改用該欄位。

6. 6
   貼上模型 ID

   從 UnoRouter 模型頁面手動輸入或貼上精確的模型名稱。

7. 7
   儲存

   關閉設定面板，RisuAI 會將設定寫入瀏覽器本機儲存。

8. 8
   送出測試訊息

   開啟任一聊天並送出測試訊息以驗證回應。

為什麼 autofill 開關很重要

Autofill Request URL 最初是為了避免在預設供應商名稱中打錯字而加入的。但對於 Custom Models，它反而成了自傷工具：RisuAI 會把你的自訂 URL 改寫為並不指向我們的預設值。如果 RisuAI 更新把此開關重新開啟，請先重做步驟 3 再去排查其他問題。

設定 Auxiliary Model

RisuAI 使用第二個模型欄位執行翻譯、摘要與名稱推測等任務。請在 Auxiliary Model 選擇器上重複步驟 2 到 7，使用相同的 UnoRouter URL 與金鑰。

疑難排解

• 404 或「Invalid URL」。 貼上時 Autofill Request URL 是開啟的，RisuAI 已改寫 URL。請取消勾選該開關並重新貼上 Request URL。
• 先前能用，現在沒有回應。 RisuAI 更新可能會悄悄地重新啟用 Autofill Request URL。請開啟 Custom Models 確認它仍為關閉狀態。
• 401 Unauthorized。 RisuAI 部分版本同時提供 API Key 與 Authorization 欄位，但會根據版本只讀取其中一個。請將金鑰移到另一個欄位後再試。
• 找不到模型。 Model ID 必須與模型名稱完全相符。請從 UnoRouter 模型頁面複製貼上，不要手動重新輸入。
• 翻譯或摘要功能失效。 Auxiliary Model 尚未設定。請為 Auxiliary Model 欄位重新進行設定。
• 串流輸出被切塊或遺漏部分內容。 RisuAI 的 SSE 解析器預期收到純粹的 `data:` 事件。企業代理如果去除前綴會讓串流內容變得錯亂。若可行，請改在非企業網路測試。
• 重新啟動瀏覽器後設定被重置。 RisuAI 將設定存放於瀏覽器本機儲存，部分隱私模式會將其清除。請於 Settings 中將設定匯出為檔案以作備份。