Xử lý lỗi 401 và 403
401 Unauthorized (chưa xác thực)
Ý nghĩa: máy chủ không nhận diện được danh tính của bạn, thường là vấn đề về key.
| Nguyên nhân | Kiểm tra | Cách xử lý |
|---|---|---|
| Key ghi sai/sao chép không đầy đủ | Đối chiếu key gốc | Sao chép lại (bản gốc khi tạo), hoặc xóa rồi tạo lại |
| Key đã bị vô hiệu hóa/xóa | Trạng thái trong danh sách key ở bảng điều khiển | Bật lại hoặc tạo mới |
| Định dạng header yêu cầu sai | Phải là Authorization: Bearer sk-xxx | Sửa lại header yêu cầu |
| Điền mật khẩu đăng nhập thay vì API Key | Xác nhận đã điền key bắt đầu bằng sk- | Đổi sang API Key |
| Key hết hạn | Kiểm tra thời gian hết hạn của key | Tạo lại hoặc gia hạn hiệu lực |
403 Forbidden (không có quyền)
Ý nghĩa: máy chủ nhận ra bạn, nhưng từ chối quyền truy cập tài nguyên đó.
| Nguyên nhân | Kiểm tra | Cách xử lý |
|---|---|---|
| Nhóm mà key liên kết không có model này | Danh sách model của nhóm | Đổi nhóm hoặc đổi model |
| Nhóm bị vô hiệu hóa/ngừng cung cấp | Thông báo trên trang | Chờ khôi phục hoặc đổi nhóm |
| Kênh từ chối (kiểm soát rủi ro) | Thử lại sau | Giảm số lượng đồng thời, hoặc liên hệ support (support@kuaiapi.net) |
| IP bị hạn chế | Danh sách IP trắng của key | Kiểm tra IP đầu ra, liên hệ support (support@kuaiapi.net) |
Công cụ kiểm tra
- Kiểm tra lần gọi đầu tiên: tính năng ở trang key, giúp xác định nhanh khâu gặp vấn đề
- Chi tiết một yêu cầu: xem mã trạng thái và nguyên nhân của yêu cầu thất bại trong lịch sử sử dụng
- Kiểm tra thô bằng curl (loại trừ ảnh hưởng từ client):
bash
curl https://kuaiapi.net/v1/models \
-H "Authorization: Bearer sk-your-key"Gợi ý dự phòng
- Xác nhận key khớp với giao thức nền tảng của nhóm (đừng lấy key Anthropic đi gọi endpoint OpenAI)
- Nếu vẫn không giải quyết được, hãy giữ lại ID yêu cầu / thời gian / mã trạng thái và liên hệ support (support@kuaiapi.net)