進階臨時
AI 錯誤碼解析
當 Verity 調用 LLM 服務失敗時，會返回對應的 HTTP 錯誤碼。 本文列出常見的錯誤碼及其含義，幫助你快速定位問題。
客户端錯誤（4xx）
400Bad Request（請求格式錯誤）
發送給 API 的請求參數不正確，例如 JSON 格式錯誤、缺少必填字段或參數值不合法。通常由客户端配置問題引起。
401Unauthorized（未授權）
API Key 無效、已過期或未提供。請檢查你的 Key 是否正確，或在服務商控制枱重新生成。
403Forbidden（禁止訪問）
Key 有效但沒有權限訪問所請求的資源。可能是賬户未完成實名認證，或所選模型未開通。
404Not Found（資源不存在）
請求的模型或接口地址不存在。請檢查 Base URL 和 Model 名稱是否正確。
408Request Timeout（請求超時）
服務器在規定時間內未收到完整請求。可能因網絡不穩定導致，建議檢查網絡後重試。
422Unprocessable Entity（參數無法處理）
請求格式正確但內容不合法，例如消息內容過長、包含不支持的參數等。
429Too Many Requests（請求頻率過高）
在短時間內發送了過多請求，觸發了服務商的速率限制。建議等待 1–2 分鐘後重試，或切換到其他 AI 提供商。
服務端錯誤（5xx）
500Internal Server Error（服務器內部錯誤）
服務商內部出現異常。這不是你的問題，通常服務商會在短時間內修復。請稍後重試。
502Bad Gateway（網關錯誤）
網關從上游服務器收到了無效響應。通常是服務商臨時故障，稍等片刻重試即可。
503Service Unavailable（服務不可用）
服務暫時過載或正在維護中。請稍後重試一次。如果持續出現，可嘗試切換到其他 AI 提供商。
504Gateway Timeout（網關超時）
網關等待上游服務器響應超時。可能是服務商負載較高，建議等待後重試。
排查建議
- 遇到429時， 等待一兩分鐘再重試，或直接切換到其他 AI 提供商。
- 遇到503時， 通常只需再試一次即可恢復。
- 持續出現 4xx 錯誤時，優先檢查 API Key 和 Base URL 配置是否正確。
- 如果所有提供商都不可用，可能是本地網絡問題， 請檢查網絡連接或代理設置。