Mã lỗi API
Các mã lỗi thường gặp khi gọi Kimi API và cách khắc phục.
Bảng tra cứu mã lỗi
| Mã lỗi | Ý nghĩa | Cách khắc phục |
|---|---|---|
| 400 | Bad Request | Kiểm tra định dạng phần thân yêu cầu, tên và kiểu của các tham số. Nguyên nhân thường gặp: JSON sai định dạng, thiếu tham số bắt buộc, giá trị nằm ngoài khoảng cho phép. |
| 401 | Unauthorized | Xác minh API Key có chính xác, chưa hết hạn hoặc chưa bị vô hiệu hóa. Kiểm tra đúng định dạng header: Authorization: Bearer <your-api-key>. |
| 403 | Forbidden (Insufficient Balance) | Số dư tài khoản đã cạn — hãy nạp thêm trong console. Tài khoản cũng có thể đang bị hạn chế; liên hệ bộ phận hỗ trợ nếu cần. |
| 404 | Not Found | Kiểm tra đường dẫn URL của yêu cầu và tên model. Xác nhận endpoint là https://api.moonshot.ai/v1/.... |
| 429 | Too Many Requests | Đã vượt quá rate limit. Hãy giảm tần suất, áp dụng exponential backoff, hoặc liên hệ bộ phận hỗ trợ để được nâng giới hạn. |
| 500 | Internal Server Error | Sự cố máy chủ tạm thời — hãy thử lại sau. Nếu vẫn tiếp diễn, liên hệ [email protected] kèm theo request_id. |
Mẹo khắc phục sự cố chung
- Đọc kỹ toàn bộ thông báo lỗi: Phần JSON phản hồi có chứa
error.messagevới mô tả chi tiết. - Ghi lại request_id: Giúp bộ phận hỗ trợ nhanh chóng xác định vấn đề.
- Tham khảo tài liệu chính thức: Đảm bảo lệnh gọi của bạn khớp với tài liệu tại platform.kimi.ai.
- Triển khai cơ chế thử lại: Với lỗi 429 và 500, hãy dùng exponential backoff.