大模型連線問題

測試連線失敗

1. 開啟 設定 → 大模型，編輯對應設定，點擊 測試連線。
2. 確認 API Key 為有效字面值，或環境變數名在本機已 export。
3. 若使用覆寫 Base URL，檢查是否多寫路徑、是否需代理。
4. 公司網路是否攔截對 api.openai.com 等網域的存取。

常見錯誤

現象	處理
401 / Invalid API Key	BYOK：重新產生 Key 並更新設定；Newton：重新登入帳戶
402 / 餘額不足	Newton：前往 控制台 或 儲值
404 / model not found	核對模型 ID 拼字與帳號權限；Newton 確認模型清單已重新整理
429 / rate limit	降低並行或更換廠商 / 模型
逾時 / 服務不可用	檢查網路、代理、Base URL；Newton 可稍後重試或暫時改用 BYOK

Newton 專用排查

1. 確認桌面端已 登入 Mystilink 帳戶（非僅貼上啟用碼）。
2. 對話過期時重新登入後再拉模型清單。
3. 餘額為 0 或不足時先儲值，見 Newton 計費。
4. 使用說明見 Newton LLM。

主模型不可用

若已開啟 自動回退，確認至少有兩條可用設定。否則暫時將另一條設為 主模型（可在 Newton 與 BYOK 之間切換）。

金鑰安全

• 勿將 BYOK Key 或帳戶憑證提交到 Git 或螢幕截圖外傳。
• Mystilink 不會把你的 BYOK Key 上傳到伺服器；BYOK 請求直連廠商。
• 不要把帳戶登入權杖當作可分享的「API Key」。

更多說明：Newton LLM、大模型與廠商、官方平台 API Key 設定、OpenAI 相容供應商設定、本機大模型部署設定、FAQ：大模型與隱私。