錯誤與重試

請勿重試所有失敗。再次傳送請求前,請先修正 400401403404 錯誤。對於逾時、429 及暫時性的 5xx 回應,只能在有限次數內使用指數退避與隨機抖動重試。

狀態碼優先處理方式
400驗證欄位、協定及模型功能
401檢查 API 金鑰與驗證 Header
403檢查金鑰、模型、群組及 IP 限制
404檢查最終 URL、端點與模型 ID
429檢查配額與並行數,再進行退避
5xx在有限次數內重試

GetRouter 不保證每個 429 都包含 Retry-After。如果有提供,請依其指示處理;否則使用有界指數退避。請保護工具呼叫、媒體工作及其他具有副作用的操作,避免重複執行。

請記錄時間戳記、狀態碼、端點、模型 ID、請求 ID 與重試次數。切勿記錄完整的 API 金鑰。