連線疑難排解

請依序完成以下檢查,每次只變更一項設定。

1. 確認 API 金鑰

  • 移除開頭或結尾的空白。
  • 確認金鑰已啟用、尚未到期,且仍有剩餘配額。
  • 確認程序能讀取已設定的環境變數。
  • 請勿將完整金鑰貼到記錄或支援訊息中。

2. 確認協定與 URL

協定Base URL用戶端附加的操作路徑
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Claude Messageshttps://getrouter.ai/v1/messages
Geminihttps://getrouter.ai/v1beta/models/...

404 通常表示用戶端重複附加了 /v1 或操作路徑。

3. 確認模型

  • Models 複製完整且正確的模型 ID。
  • 確認該金鑰獲准使用此模型。
  • 確認模型支援所請求的協定與功能。
  • 如果工具無法載入模型清單,請手動輸入模型。

4. 判讀常見狀態碼

狀態碼優先檢查項目
400不支援的欄位、無效請求或功能不相符
401缺少 API 金鑰或金鑰無效
403金鑰、模型、群組或政策限制
404URL/路徑錯誤或模型不明
429餘額、配額、並行數或速率限制
5xx暫時性的上游或閘道失敗

5. 測試最小請求

停用工具、檔案、圖片、長上下文、JSON 模式及自訂推理設定。傳送一則簡短的文字提示,再逐一加回進階功能。

安全地尋求協助

請提供工具/版本、協定、模型 ID、經遮蔽的 Base URL 設定、HTTP 狀態碼、錯誤文字、Request ID,以及包含時區的時間。切勿提供完整的 API 金鑰。