Gần đây tôi dùng Claude API để làm dự án, kết quả là đủ loại lỗi hiện ra khiến tôi đau đầu. Vật lộn vài ngày, giờ tôi tổng hợp lại những lỗi đã gặp, hy vọng có thể giúp được những bạn đang gặp rắc rối tương tự.
Error 401 Unauthorized
Lỗi này phổ biến nhất, phần lớn là do vấn đề với API Key. Hãy kiểm tra xem Key có được sao chép đầy đủ không, đặc biệt là phần tiền tố "sk-ant-" có bị thiếu không. Ngoài ra, Key hết hạn hoặc bị thu hồi cũng sẽ báo lỗi này, bạn chỉ cần vào phần quản lý Anthropic để tạo một Key mới là được.
Error 429 Rate Limit Exceeded
Yêu cầu quá thường xuyên nên bị giới hạn tốc độ. Tài khoản miễn phí chỉ có thể yêu cầu 60 lần mỗi phút, tài khoản trả phí sẽ có giới hạn cao hơn. Giải pháp:
- Thêm độ trễ vào code, ví dụ mỗi lần yêu cầu cách nhau 1 giây
- Sử dụng chiến lược "exponential backoff" để xử lý việc thử lại
- Nâng cấp gói tài khoản để tăng giới hạn
Error 529 Overloaded
Máy chủ Claude quá tải, trường hợp này chỉ cần đợi vài phút rồi thử lại. Nếu xuất hiện thường xuyên, bạn có thể cân nhắc sử dụng vào giờ thấp điểm, tránh giờ cao điểm ở các múi giờ Bắc Mỹ.


