Bạn đã viết code, cài đặt prompt, nhưng khi chạy lại nhận ngay lỗi: Invalid API key, 401, 403, Access denied… Cảm giác như "mình chẳng làm gì sai". Đây là vấn đề phổ biến khi gọi API của ChatGPT, Claude, Gemini. Ngay cả Midjourney nếu dùng qua API bên thứ ba cũng dễ gặp phải.
1. Khóa bị dán sai vị trí hoặc chứa khoảng trắng
Lỗi phổ biến nhất: sao chép kèm theo ký tự xuống dòng, khoảng trắng thừa ở đầu/cuối, hoặc điền Key nhầm vào ô Base URL. Hãy sao chép lại Key một lần nữa và kiểm tra thủ công các ký tự ở đầu và cuối chuỗi.
2. Biến môi trường chưa có hiệu lực
Bạn tưởng đã export xong, nhưng dịch vụ chưa được khởi động lại; code chạy được trên máy local nhưng lại lỗi khi deploy lên server. In ra một dòng log khi khởi động chương trình để kiểm tra "độ dài KEY đã được đọc" sẽ nhanh hơn việc đoán mò.
3. Dùng sai dự án hoặc tài khoản không có quyền
Một số nền tảng ràng buộc Key với "dự án/tổ chức" cụ thể, chuyển sang dự án khác sẽ ngay lập tức nhận 401; cũng có trường hợp Key bị bạn vô tình xóa hoặc vô hiệu hóa. Hãy vào bảng điều khiển (console) để xác nhận trạng thái Key, đừng cố gắng suy đoán.
4. Hạn chế truy cập mạng hoặc khu vực
Lỗi 403 không nhất thiết là do Key sai, mà có thể do mạng bị chặn, IP đầu ra không "sạch". Trước tiên, hãy dùng tính năng kiểm tra (test) trên bảng điều khiển chính thức của nhà cung cấp để xác minh Key, sau đó mới kiểm tra vấn đề mạng.
5. Vấn đề về dependency và build process bị nhầm là lỗi Key
Tôi đã gặp trường hợp dự án Node.js do xung đột dependency (ERESOLVE), phiên bản không tồn tại (ETARGET), thư mục còn sót lại (ENOTEMPTY) khiến thư viện request không gửi được, và cuối cùng báo lỗi chung chung là "Xác thực thất bại", rất khó chịu. Hãy đảm bảo quá trình build chạy thành công trước khi đánh giá lỗi Key.
Danh sách kiểm tra nhanh
- Cùng một Key đó có chạy được với ví dụ mẫu chính thức/trên console hay không
- Key có chứa khoảng trắng, đã hết hạn hoặc bị vô hiệu hóa chưa
- Biến môi trường có thực sự tồn tại trong tiến trình đang chạy không
- Phân biệt mã lỗi là 401 hay 403 để xử lý riêng
- Đã cài đặt dependency thành công không có lỗi trước khi khởi động dịch vụ chưa
Nếu bạn vẫn đang mất thời gian xoay quanh các vấn đề về gói đăng ký, thanh toán, hạn chế khu vực hoặc tài khoản bất thường, hãy tiết kiệm thời gian của mình. Tham khảo các giải pháp và danh sách công cụ ổn định hơn tại Titikey để tránh các lỗi không đáng có, điều này thực sự giúp bạn tiết kiệm rất nhiều công sức.
