API 錯誤排查：401、403、429、502 錯誤碼說明

88API 回傳 401、403、404、429、5xx 錯誤的含義與處理方法，涵蓋令牌無效、餘額不足、請求過快及 Claude Code、Codex 報錯。

呼叫失敗時，介面會回傳 HTTP 狀態碼和一段 JSON，錯誤原因寫在 error.message 裡：

{
  "error": {
    "code": "",
    "message": "無效的令牌 (request id: 2026101605444223...)",
    "type": "new_api_error"
  }
}

message 末尾的 request id 是這次請求的編號，聯絡客服時請一併提供。控制台的「使用日誌」頁面也會記錄失敗請求的時間、模型和錯誤訊息。排查時先看狀態碼，再看 message。

錯誤訊息會依照個人設定裡儲存的語言（或用戶端的 Accept-Language 標頭）顯示；兩者都沒有時可能以簡體中文回傳，含義與下方說明相同。

速查表

狀態碼	含義	先做什麼
400	請求內容或參數不被模型接受	依報錯訊息修改參數、提示詞或圖片
401	令牌無效	檢查 API Key 是否填對、是否已刪除
403	令牌不可用、餘額不足或沒有權限	檢查餘額、令牌狀態、令牌的分組和模型限制
404	地址或模型不存在	檢查介面地址是否多了 `/v1`，模型名稱是否在目前分組可用
429	請求過快或模型繁忙	降低頻率，稍後重試
500、502、503、504、524	模型服務暫時無法使用或逾時	稍後重試；持續失敗時換分組或換模型

401：令牌無效

常見訊息：無效的令牌、invalid token。

API Key 複製不完整，或前後帶了空格、換行。
令牌已在控制台刪除。到 API 令牌頁面重新建立或複製。
Claude Code：同時設定了舊的 ANTHROPIC_API_KEY。它的優先順序高於 ANTHROPIC_AUTH_TOKEN，請刪除它，只保留 ANTHROPIC_AUTH_TOKEN。
請求標頭寫法：OpenAI 格式用 Authorization: Bearer sk-...；Anthropic 格式用 x-api-key: sk-...。

403：令牌不可用、餘額不足或沒有權限

餘額或額度不足

常見訊息：使用者額度不足、預扣費額度失敗，使用者剩餘額度：…，需要預扣費額度：…。

帳戶餘額不夠本次請求的預扣費。請到錢包儲值。
帳戶有餘額但仍提示不足：令牌可以單獨設定額度上限，請檢查該令牌的剩餘額度。
Claude Code 會把這類 403 顯示成「認證失敗」或「API Error 403」，處理方法相同。

令牌狀態不可用

常見訊息：該令牌狀態不可用。

令牌被停用、已過期或令牌額度已用完。在 API 令牌頁面啟用令牌、修改過期時間或調整額度。

沒有分組或模型權限

常見訊息：無權存取 … 分組、API Key 所属专属分组不再允许当前用户使用、該令牌無權存取模型 …。

令牌綁定的分組目前帳戶不能使用：編輯令牌，換成模型廣場裡可用的分組。
令牌設定了模型限制：在令牌設定裡開放對應模型，或者換一個令牌。

目前分組不支援這個介面

常見訊息：This group does not allow /v1/messages dispatch。

所選分組不支援這種協定的介面（例如用只支援 OpenAI 格式的分組去呼叫 Anthropic 的 /v1/messages）。Claude Code 請使用 Claude 分組的令牌；其他用戶端依模型廣場裡該模型支援的介面類型呼叫。

404：地址或模型不存在

地址多了或少了 /v1

常見訊息：Invalid URL、404 page not found。

Claude Code 的 ANTHROPIC_BASE_URL 填 https://api.88api.ai，不要加 /v1（Claude Code 會自己拼接 /v1/messages，寫成 .../v1 會變成 /v1/v1/messages）。
Codex 的 base_url 填 https://api.88api.ai/v1，必須帶 /v1。
大多數 OpenAI 相容應用填 https://api.88api.ai/v1。各應用的寫法見應用串接教學。

模型在目前分組不可用

常見訊息：分組 … 下模型 … 無可用管道、Model "…" is not supported by any configured account in this group、model not found。

模型名稱寫錯，或者帶了多餘的前綴、後綴。在個人設定或模型廣場裡複製準確的模型名稱。
該模型不在令牌所選的分組裡。在模型廣場查看模型支援哪些分組，然後修改令牌的分組。

400：請求內容或參數不被接受

報錯訊息（範例）	原因和處理
`输入内容超过模型上下文限制`、`Input exceeds the context limit`	對話太長。刪減歷史紀錄或開新對話；Claude Code 裡可以用 `/compact` 壓縮上下文
`请求中包含该模型不支持的参数（如 presence_penalty / frequency_penalty）`	去掉報錯裡提到的參數
`该模型是生图模型，不能通过对话接口调用`	生圖請用 `/v1/images/generations`，改圖用 `/v1/images/edits`，見圖片介面
`请使用 Gemini 原生接口调用`	該模型只支援 Gemini 原生格式，見 Gemini 介面
`the selected model cannot disable reasoning`、`不支持关闭深度思考`	這個模型必須開啟思考，去掉關閉思考的參數（或把思考類型設為 enabled）
`requires adaptive thinking`	該 Claude 模型要求自適應思考：去掉 `thinking` 參數，或依報錯提示改成 `type=adaptive`
`当前输入触发平台内容安全规则`、`未通过内容安全审核`、`可能违反了…内容政策`	提示詞或參考圖被安全審核攔截，修改內容後再試
`Failed to download multimodal content`、`mime type is not supported`	圖片網址無法存取或格式不支援。換成公開網路可存取的 PNG、JPEG、WebP 圖片，或改用 base64

429：請求過快或繁忙

帳戶請求頻率超限

常見訊息：您的請求頻率過快；目前使用者群組 … 分鐘內最多允許 … 次成功請求。

預設限制為 60 RPM（每分鐘請求數）。降低並發或在用戶端加入重試間隔；確實需要更高的頻率，可以聯絡客服申請提高。

模型繁忙

常見訊息：Upstream rate limit exceeded、service error, please try again later、Concurrency limit exceeded。

模型目前請求量大。稍等幾秒重試；需要穩定可以在模型廣場換一個分組。

500、502、503、504、524：服務暫時無法使用或逾時

常見訊息：Upstream service temporarily unavailable、Service temporarily unavailable. Please retry.、系统过载，请稍后重试、模型请求失败，请稍后重试或更换模型、bad response status code 504。

這類錯誤多是模型服務一時繁忙或網路波動，通常重試即可恢復。建議用戶端按 1 秒、2 秒、4 秒逐步加大間隔重試。
同一個模型持續失敗時，換一個分組或換一個模型。
524、504 多發生在生成時間很長的請求上：對話請求請開啟串流輸出（stream: true）；生圖、影片請用非同步任務介面輪詢結果。

仍然無法解決

在使用日誌裡找到失敗的那筆紀錄，把**請求時間、模型名稱、狀態碼和完整報錯訊息（含 request id）**發給線上客服。不要傳送你的完整 API Key。

錯誤碼與常見報錯

速查表