常見報錯碼怎麼讀

401 / 402 / 404 / 429 / 5xx 分別代表什麼、先查什麼。

401 未授權

令牌無效、被刪除或寫錯了。先確認 Authorization 頭的格式是 Bearer sk-xxx,注意 Bearer 後面有一個空格。

402 額度不足

餘額不夠本次請求的預扣。充值後立即恢復,不需要改任何配置。

404 找不到

九成是地址寫錯。確認用的是 https://api.router.ai/v1/..., 且沒有把 /v1 寫重或漏寫。也可能是模型名拼錯——模型名以「模型廣場」為準。

429 頻率限制

觸發了限流。降低併發或稍後重試;持續需要更高併發請聯絡我們。

5xx 上游異常

上游模型服務出問題。我們會透傳上游的原始錯誤體便於定位。 這類通常是暫時的,重試即可;如果某個模型持續 5xx,請反饋給我們。

排查順序建議:先看狀態碼 → 再看返回體裡的 message → 最後查計費流水。 如果計費流水裡根本沒有這筆,說明請求沒到達我們,問題在客戶端配置。

部落格