連接 AI 供應商
預設值、金鑰、連線測試,以及如何解讀錯誤。
閱讀約 3 分鐘
NovelKnow 不綁定任何模型供應商——您自行提供 API 金鑰,使用哪個模型、花費多少,都由您決定。
快速上手
AI 設定 → 點選供應商預設值 → 貼上您的金鑰 → 測試連線 → 儲存。
預設值會自動填入基礎 URL、預設模型與上下文視窗。這三項是最常出錯的地方,也是設定無法運作的常見原因。
內建預設值:DeepSeek、OpenRouter、OpenAI、Kimi / Moonshot、Qwen / DashScope、SiliconFlow,以及本機 Ollama。
任何 OpenAI 相容端點都可以使用——選擇自訂選項,自行輸入基礎 URL 即可。
模型清單
儲存後,「同步模型」會從供應商擷取實際的模型清單。之後模型下拉選單就會由該清單填入,因此您永遠不必手動輸入模型名稱。
把常用的模型標為最愛,它們就會排在最上方。
解讀錯誤
連線測試與生成失敗時,訊息會包含供應商自己的回應,因此您可以區分以下情況:
| 錯誤訊息包含 | 通常代表 |
|---|---|
401 / Incorrect API key | API 金鑰錯誤或已過期 |
404 / model does not exist | 模型名稱錯誤,或您的帳戶沒有該模型的存取權 |
429 | 觸發速率限制,或帳戶已無額度 |
fetch failed / ECONNREFUSED | 伺服器無法連到供應商——請看下方的代理說明 |
對外代理
如果您的部署無法連到供應商,請在 AI 設定對話框中啟用對外代理。
**該位址是從部署伺服器解析,而不是從您自己的電腦解析。**將它指向 127.0.0.1:7890 只有在伺服器本身正執行代理程式時才有意義。
金鑰的儲存方式
金鑰會以從您帳戶衍生的金鑰加密,而且只會以遮罩形式傳回瀏覽器。您之後永遠不會再看到自己的完整金鑰——若要更換,貼上新的金鑰即可。