報錯代碼說明

報錯代碼說明

呼叫 API 或使用網站遇到報錯時,對照本文排查。

401 Unauthorized

含義:API Key 無效。

排查:

  1. Key 是否複製完整(sk- 開頭,無多餘空格)
  2. Key 是否已被刪除,到 API Key 管理 確認
  3. 環境變數是否生效(重新開啟終端機)

403 Forbidden

含義:沒有權限存取該資源。

排查:Key 被停用,或 IP 被限制。到 API Key 管理 檢查 Key 狀態。

404 Not Found

含義:模型不存在或路徑錯誤。

排查:

  1. 模型名是否和模型廣場完全一致(區分大小寫)
  2. Base URL 是否帶 /v1 後綴

429 Too Many Requests

含義:請求過於頻繁,觸發限速。

解決:稍等幾秒重試;高頻場景在程式碼中加入重試邏輯。

餘額不足

含義:帳戶餘額不夠本次呼叫。

解決:到儲值頁面儲值。

500 / 502 / 503

含義:服務端臨時錯誤。

解決:稍後重試。持續出現,到我的表單提交工單。