# 錯誤 (/zh-Hant/docs/concepts/errors)

HTTP 狀態碼、錯誤主體的格式，以及哪些錯誤應該重試。



錯誤會以非 2xx 狀態碼回傳，主體為 OpenAI 格式的 JSON：

```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`。

## 狀態碼 [#status-codes]

| 狀態碼                                                  | 意義                                                                                                                                            | 處理方式                                                                                                                       |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `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`。請參閱[取樣參數限制](/zh-Hant/docs/concepts/models#sampling-limits)。 |
| `401`                                                | Key 缺少、無效、已到期，或預算已用盡。                                                                                                                         | 在控制台檢查這組 Key。                                                                                                              |
| `403`                                                | 這組 Key 不允許這次呼叫（模型或 IP 允許清單），或你的餘額不足。                                                                                                          | 調整 Key 的選項或儲值。                                                                                                             |
| `429`                                                | 請求過多。                                                                                                                                         | 以指數退避重試。請參閱[速率限制](/zh-Hant/docs/concepts/rate-limits)。                                                                     |
| `503` 且 `code: model_not_found`                      | 沒有任何上游提供這個模型 ID。                                                                                                                              | 在[目錄](/zh-Hant/models)中確認模型 ID。                                                                                            |
| `500`、`502`、`503`、`504`                              | 閘道或上游供應商發生故障。                                                                                                                                 | 以退避方式重試。                                                                                                                   |

在抵達模型之前就以 `4xx` 拒絕的請求不會收費。

## 請求 ID [#request-ids]

每個回應都帶有 `X-Oneapi-Request-Id` 標頭，錯誤訊息中也會重複這個 ID。聯絡[支援](/zh-Hant/docs/support)時請附上它。