Aiberm logo
登入

錯誤處理

當 Aiberm API 請求失敗時，API 會回傳 JSON 錯誤物件。請使用 HTTP 狀態碼、error.code 和 error.message 來判斷問題並決定下一步。

若需要支援，請附上包含所有 request id 的完整錯誤回應。

錯誤回應格式

{
  "error": {
    "message": "用户额度不足, 剩余额度: ¥0.00 (request id: 20260622xxxxxxxx)",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}
欄位意義
message可讀的錯誤訊息。結尾的 (request id: ...) 是此請求的追蹤 ID。聯繫支援時請一併提供。
code錯誤類別識別碼。請與下方常見錯誤對照。
type錯誤來源標記。大多數情況下不需要直接處理。

若 message 包含多個 (request id: ...)，這是正常的。代表請求經過多個服務層。聯繫支援時請複製完整錯誤訊息。

HTTP 狀態碼

狀態意義該怎麼做
400請求格式無效檢查請求 JSON、必填欄位、Content-Type 和模型名稱。
401API 金鑰無效檢查 API 金鑰是否正確、過期、停用或額度用盡。
403無權限或餘額不足檢查帳戶餘額、權杖權限、模型權限和來源 IP。
404找不到資源檢查端點 URL 和模型名稱拼寫。
429請求過多降低並行或請求頻率，稍後再試。
500內部伺服器錯誤稍後再試。若持續發生，請帶著 request id 聯繫支援。
503暫時無法提供服務該模型目前沒有可用路由。稍後再試或聯繫支援。

API 金鑰與認證錯誤

這些錯誤通常回傳 401。

可能看到的訊息常見原因如何修正
无效的令牌API 金鑰不正確或不存在。確認金鑰完整且沒有多餘或缺少字元。請從控制台重新複製。
该令牌已过期權杖已過期。在控制台重新產生權杖，或延長有效期限。
该令牌额度已用尽此權杖分配的額度已用完。提高權杖額度，或改用額度足夠的權杖。
该令牌状态不可用權杖已停用。在控制台啟用權杖，或建立新的。
未提供令牌請求未包含 API 金鑰。在請求標頭加入 Authorization: Bearer sk-xxxxxx。

權限與餘額錯誤

這些錯誤通常回傳 403。

可能看到的訊息常見原因如何修正
用户额度不足, 剩余额度: ...帳戶餘額不足以完成此請求。儲值後再試。
预扣费额度失败, 用户剩余额度: ...餘額不足以覆蓋預估請求成本。儲值，或降低 max_tokens 並縮短輸入。
您的 IP 不在令牌允许访问的列表中權杖設有 IP 允許清單，目前 IP 不在其中。使用允許的 IP，或在控制台更新允許清單。
用户已被封禁帳戶已被停權。聯繫支援了解詳情。
无权访问 xxx 分组權杖無法存取所請求的群組。使用允許的群組，或申請存取權。
该令牌无权访问模型 xxx權杖允許的模型清單不包含此模型。使用允許的模型，或在控制台更新權杖的模型權限。

請求內容錯誤

這些錯誤通常回傳 400。

可能看到的訊息常見原因如何修正
Invalid request, ...無法解析請求本文。確認 JSON 有效，且 Content-Type 為 application/json。
未指定模型名称，模型名称不能为空請求缺少 model 欄位。在請求本文加入正確的 model。
類似 检测到敏感词 的訊息輸入符合內容安全規則。調整輸入後再試。

速率限制錯誤

這些錯誤通常回傳 429。

可能看到的訊息常見原因如何修正
您已达到请求数限制：N分钟内最多请求M次已達到成功請求上限。降低請求頻率，等限制視窗重置後再試。
您已达到总请求数限制：...，包括失败次数...已達到總請求上限（包含失敗請求）。檢查是否有失敗請求在循環，修正原因後再試。

模型與路由錯誤

這些錯誤通常回傳 404 或 503。

可能看到的訊息常見原因如何修正
模型不存在模型名稱拼錯，或此權杖未啟用該模型。確認模型名稱與權杖的模型權限。
无可用渠道該模型目前沒有可用路由。稍後再試。若持續不可用，請聯繫支援。

伺服器錯誤

這些錯誤通常回傳 500 或 503。

可能看到的訊息常見原因如何修正
內部錯誤訊息暫時的伺服器問題，或上游服務暫時不可用。稍後再試。若持續發生，請帶著 request id 聯繫支援。

聯繫支援前

為了更快定位問題，請提供：

  1. 完整錯誤回應，包含 message、code 和每個 request id。
  2. 問題發生的大約時間。
  3. 您呼叫的模型名稱和端點 URL。
  4. API 金鑰的前幾個字元，例如 sk-abcd...。請勿傳送完整金鑰。
在 GitHub 上編輯此頁