Khi tích hợp ChatGPT, Claude, hay Gemini vào các ứng dụng client hoặc plugin của bên thứ ba, vấn đề thường gặp nhất chính là lỗi API Key: bạn đã sao chép và dán chính xác, nhưng vẫn nhận được thông báo "invalid key", lỗi 401 hoặc "unauthorized". Quy trình kiểm tra dưới đây gần như luôn giúp tôi khắc phục thành công.
Đừng vội cài lại: 5 nguyên nhân phổ biến nhất
1. Khoá API bị dính khoảng trắng hoặc xuống dòng
Đặc biệt khi sao chép từ trình duyệt web sang file cấu hình, chỉ một dấu cách thừa ở cuối cũng đủ gây rắc rối. Cách đơn giản nhất là gõ lại key thủ công một lần.
2. Đặt key sai chỗ hoặc biến môi trường không hoạt động
Nhiều công cụ hỗ trợ đồng thời "file cấu hình" và "biến môi trường", nhưng bạn sửa A thì nó lại đọc B. Lời khuyên là hãy tìm kiếm cụm "key from" trong log hoặc kiểm tra thứ tự ưu tiên đọc key trong tài liệu của plugin.
3. Chọn nhầm nhà cung cấp hoặc tên model
Các client hỗ trợ đa model rất dễ xảy ra việc dùng tên model của OpenAI để gửi request tới Claude, và lỗi trả về khá giống nhau. Đừng dựa vào trí nhớ, hãy sao chép chính xác tên model từ bảng điều khiển.
4. Vấn đề về quyền hạn hoặc hạn mức sử dụng
Một số key mặc định chưa bật tính phí, chưa liên kết thẻ thanh toán, hoặc chưa được cấp quyền truy cập API cụ thể, sẽ bị xem là "không hợp lệ". Kiểm tra mục Usage và Billing trong bảng điều khiển sẽ hiệu quả hơn là chỉ nhìn vào thông báo lỗi.
