# Lỗi (/vi/docs/concepts/errors)

Mã trạng thái HTTP, body lỗi và những lỗi nên thử lại.



Lỗi được trả về với mã trạng thái khác 2xx và body JSON theo định dạng OpenAI:

```json
{
  "error": {
    "message": "Invalid token (request id: 2026100912391754811973...)",
    "type": "new_api_error",
    "code": ""
  }
}
```

Xử lý theo mã trạng thái HTTP (và theo `error.code` khi trường này không rỗng). `message` dành cho người đọc và có thể thay đổi.

Nếu lỗi đến từ nhà cung cấp upstream sau khi yêu cầu đã được chấp nhận, body lỗi có thể theo định dạng riêng của nhà cung cấp đó; trên `/v1/messages` là định dạng Anthropic, `{ "type": "error", "error": { "type": "...", "message": "..." } }`. Cả hai định dạng đều có `error.message`.

## Mã trạng thái [#status-codes]

| Trạng thái                                            | Ý nghĩa                                                                                                                                                                                                                                        | Cách xử lý                                                                                                                                               |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`                                                 | Yêu cầu sai định dạng.                                                                                                                                                                                                                         | Sửa body yêu cầu.                                                                                                                                        |
| `400` kèm `code: invalid_parameter_error` ở `kimi-k3` | Mô hình chỉ nhận giá trị lấy mẫu cố định, còn client của bạn gửi giá trị khác, thường là giá trị mặc định như temperature 0.7 hoặc top\_p 0.9. Thông báo lỗi nêu rõ tham số: `Parameter 'temperature'=0.7 is not supported for kimi-k3 model.` | Không gửi `temperature` và `top_p`, hoặc đặt temperature `1` và top\_p `0.95`. Xem [Giới hạn tham số lấy mẫu](/vi/docs/concepts/models#sampling-limits). |
| `401`                                                 | Key bị thiếu, không hợp lệ, đã hết hạn hoặc đã dùng hết hạn mức chi tiêu.                                                                                                                                                                      | Kiểm tra key trong bảng điều khiển.                                                                                                                      |
| `403`                                                 | Key không được phép thực hiện lượt gọi này (bị chặn bởi danh sách mô hình hoặc IP cho phép), hoặc số dư của bạn không đủ.                                                                                                                      | Điều chỉnh giới hạn của key hoặc nạp tiền.                                                                                                               |
| `429`                                                 | Quá nhiều yêu cầu.                                                                                                                                                                                                                             | Thử lại với exponential backoff. Xem [Giới hạn tốc độ](/vi/docs/concepts/rate-limits).                                                                   |
| `503` kèm `code: model_not_found`                     | Không có nhà cung cấp nào phục vụ ID mô hình này.                                                                                                                                                                                              | Kiểm tra ID mô hình trong [danh mục](/vi/models).                                                                                                        |
| `500`, `502`, `503`, `504`                            | Gateway hoặc nhà cung cấp upstream gặp lỗi.                                                                                                                                                                                                    | Thử lại với backoff.                                                                                                                                     |

Yêu cầu bị từ chối với `4xx` trước khi đến mô hình sẽ không bị tính phí.

## ID yêu cầu [#request-ids]

Mọi phản hồi đều có header `X-Oneapi-Request-Id`, và thông báo lỗi cũng ghi lại ID này. Gửi kèm ID này khi bạn liên hệ [bộ phận hỗ trợ](/vi/docs/support).