Khi viết code tích hợp ChatGPT, Claude hay Gemini, điều phiền toái nhất không phải là logic mà là những thông báo lỗi API key không hợp lệ, 401 hay 403. Bạn chắc chắn đã sao chép chính xác, nhưng hệ thống vẫn không nhận. Tôi đã tổng hợp kinh nghiệm từ những lần tự mắc lỗi thành một quy trình kiểm tra chung, có thể áp dụng cho hầu hết các trường hợp (nhiều tài liệu plugin cũng xếp chúng vào nhóm "Lỗi API key/Vấn đề mạng").
1 Trước tiên, hãy chắc chắn bạn không dùng mật khẩu tài khoản chat
API Key không phải là mật khẩu đăng nhập, cũng không phải Session từ web. OpenAI, Anthropic và Google đều có bảng điều khiển riêng, Key phải được tạo trên nền tảng tương ứng. Đừng cố dùng tài khoản ChatGPT Plus để "ghép" vào.
2 Key trông giống nhau nhưng lỗi sao chép thường gặp
Lỗi phổ biến nhất là có khoảng trắng hoặc xuống dòng thừa ở cuối, hoặc dán Key vào cấu hình có kèm dấu ngoặc kép. Bạn nên dán Key vào trình soạn thảo văn bản thuần để so sánh độ dài, sau đó sao chép lại. Đồng thời kiểm tra xem tên biến môi trường có bị viết sai không (ví dụ: OPENAI_API_KEY bị thiếu một chữ cái).
3 Quyền và dự án chưa được bật đúng cách
Với Gemini, thường là API đã bật nhưng dự án chưa liên kết tính phí hoặc chưa kích hoạt dịch vụ tương ứng. Claude cũng có thể từ chối truy cập do chính sách quyền tài khoản/khu vực. Khi gặp lỗi 403, đừng chỉ tập trung vào "Key sai", mà nhiều khi là "bạn không có quyền sử dụng".
