Lỗi
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:
{
"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
| 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. |
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 độ. |
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. |
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
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ợ.