速率限制與錯誤
各項限制，以及每個狀態碼的意思。
429 可能來自多個層面：
- 我們的免費模型上限：每位使用者、每個免費模型每分鐘 1 次請求。
- 上游限制：免費模型背後的供應商觸發了它自己的上限。
- 部分免費資源池設有每日 token 預算，在 UTC 午夜重置。
- 每分鐘 token 上限，超大的提示會觸發它。
- 針對平行請求的每位使用者並行上限。
付費模型沒有由 UnoRouter 施加的速率限制。
觸發每分鐘 1 次的上限時，你會收到標準的速率限制標頭：
HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478Retry-After 是你目前時間窗剩下的秒數，而不是固定的 60。訊息會指出對應的付費模型，它沒有這個限制。
部分付費模型以帶請求大小上限的方式免費提供。過長的提示會回傳 413：Request body too large for gpt-4.1 model. Max size: 8000 tokens。
這個上限只作用於免費路線。付費模型接受完整長度的提示。
錯誤會以 OpenAI 錯誤格式的 JSON 回傳。code 是穩定的識別碼。每則訊息結尾都會附上請求 id：
{
"error": {
"message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
"type": "new_api_error",
"code": "model_not_found"
}
}提交支援單時請附上請求 id。它能在記錄中定位你的請求。
如果你還在設定金鑰或基礎 URL，請先閱讀 快速上手
你實際會遇到的狀態碼：
| 狀態碼 | 含義 | 因應方法 |
|---|---|---|
400 | 無效請求：參數有誤，或提示被審核擋下。 | 請修正請求。原樣重試仍會失敗。 |
401 | 金鑰缺少、無效、已過期或已停用。 | 請檢查 Authorization 標頭與 Tokens 頁面。 |
402 | 此金鑰自身的支出上限已用盡。 | 提高該金鑰的上限，或建立一個新金鑰。 |
403 | 餘額為零、這把金鑰不允許使用該模型，或 IP 不在允許清單中。 | 儲值，或檢查金鑰的模型與 IP 限制。 |
413 | 請求超出該模型免費試用的大小上限。 | 縮短提示詞，或切換到付費模型。 |
429 | 觸發了某種速率限制（見下方各類）。 | 等待 Retry-After 指定的秒數，然後重試或切換模型。 |
500 | 我們這邊或上游供應商出了問題。 | 稍候片刻再重試。若 500 持續出現，請回報給我們。 |
503 | 所有供應商都很忙碌，或模型名稱不存在。 | 請看訊息內容：忙碌幾分鐘就會緩解，拼字錯誤不會。 |
兩種截然不同的情況共用狀態碼 503。第一種是暫時壅塞：
HTTP/1.1 503 Service Unavailable
{
"error": {
"message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
"type": "new_api_error",
"code": "get_channel_failed"
}
}get_channel_failed 表示該模型的所有免費供應商都被限流了。它幾分鐘內就會緩解：重試或換個模型。model_not_found 表示這個名稱無法解析，重試永遠沒用。請檢查拼字或查看目錄。
請把 get_channel_failed 當成可重試的錯誤，把 model_not_found 當成確定性的錯誤。
因負載消失的模型會自行回歸；想在它回歸的那一刻收到提醒，請在這裡關注它： 通知
如果你的金鑰釘選了供應商群組，還有第三種 503：只有你釘選的群組停機時出現，見： 群組釘選
遇到 429 時請遵守 Retry-After。遇到 503 get_channel_failed 時稍候再重試，或換個模型。400 類錯誤不要重試。
失敗與被拒絕的請求絕不計費；預扣與退款的機制見： 帳戶與帳務