錯誤
HTTP 狀態碼、錯誤主體的格式，以及哪些錯誤應該重試。
錯誤會以非 2xx 狀態碼回傳，主體為 OpenAI 格式的 JSON：
{
"error": {
"message": "Invalid token (request id: 2026100912391754811973...)",
"type": "new_api_error",
"code": ""
}
}請依 HTTP 狀態碼（以及非空時的 error.code）分支處理。message 是寫給人看的，內容可能變動。
請求被接受後由上游供應商引發的錯誤，可能會以該供應商自己的格式回傳；在 /v1/messages 上即為 Anthropic 格式：{ "type": "error", "error": { "type": "...", "message": "..." } }。兩種格式都帶有 error.message。
狀態碼
| 狀態碼 | 意義 | 處理方式 |
|---|---|---|
400 | 請求格式錯誤。 | 修正請求主體。 |
kimi-k3 回傳 400 且 code: invalid_parameter_error | 這個模型只接受固定的取樣參數，而你的用戶端送了其他值，常見的是 temperature 0.7、top_p 0.9 這類預設值。訊息會寫出是哪個參數：Parameter 'temperature'=0.7 is not supported for kimi-k3 model. | temperature 與 top_p 都不要傳，或設為 temperature 1、top_p 0.95。請參閱取樣參數限制。 |
401 | Key 缺少、無效、已到期，或預算已用盡。 | 在控制台檢查這組 Key。 |
403 | 這組 Key 不允許這次呼叫（模型或 IP 允許清單），或你的餘額不足。 | 調整 Key 的選項或儲值。 |
429 | 請求過多。 | 以指數退避重試。請參閱速率限制。 |
503 且 code: model_not_found | 沒有任何上游提供這個模型 ID。 | 在目錄中確認模型 ID。 |
500、502、503、504 | 閘道或上游供應商發生故障。 | 以退避方式重試。 |
在抵達模型之前就以 4xx 拒絕的請求不會收費。
請求 ID
每個回應都帶有 X-Oneapi-Request-Id 標頭，錯誤訊息中也會重複這個 ID。聯絡支援時請附上它。