401 / 402 / 404 / 429 / 5xx 分別代表什麼、先查什麼。
令牌無效、被刪除或寫錯了。先確認 Authorization 頭的格式是
Bearer sk-xxx,注意 Bearer 後面有一個空格。
餘額不夠本次請求的預扣。充值後立即恢復,不需要改任何配置。
九成是地址寫錯。確認用的是 https://api.router.ai/v1/...,
且沒有把 /v1 寫重或漏寫。也可能是模型名拼錯——模型名以「模型廣場」為準。
觸發了限流。降低併發或稍後重試;持續需要更高併發請聯絡我們。
上游模型服務出問題。我們會透傳上游的原始錯誤體便於定位。 這類通常是暫時的,重試即可;如果某個模型持續 5xx,請反饋給我們。
排查順序建議:先看狀態碼 → 再看返回體裡的 message → 最後查計費流水。 如果計費流水裡根本沒有這筆,說明請求沒到達我們,問題在客戶端配置。