Khi viết code để tích hợp API ChatGPT, Claude, Gemini, điều gây khó chịu nhất không phải là logic nghiệp vụ, mà là ngay lập tức nhận được lỗi 401/403/429. Đừng vội, những lỗi "khóa API sai" này thường không phải do khóa bị hỏng, mà là do các chi tiết cấu hình đang gây rắc rối.
1. 401 invalid_api_key: Trước tiên nghi ngờ cách sao chép
Tôi đã thấy nhiều trường hợp thất bại nhất: khóa sao chép thừa khoảng trắng, thiếu tiền tố, hoặc dùng key từ môi trường test cho production. Đề xuất tạo một "tái hiện tối thiểu", chỉ với một dòng request, giữ nó đơn giản (KISS), đừng tìm kim trong đống nghiệp vụ phức tạp.
2. 403 Quyền không đủ: Thường là do dự án hoặc model chưa được bật
Claude và Gemini đôi khi ràng buộc quyền với dự án, khu vực hoặc danh sách trắng model. Hãy xác nhận xem model bạn chọn có mở cho key hiện tại không, và kiểm tra trong bảng điều khiển có thông báo "cần kích hoạt API/tài khoản thanh toán" không.
3. 429 Giới hạn tốc độ: Không phải code bạn tệ, mà là do hạn mức hoặc đồng thời
429 thường có hai loại: request quá dày đặc hoặc hạn ngạch đã hết. Hãy thiết lập thử lại với backoff theo cấp số nhân, đồng thời thêm giới hạn đồng thời, ngay lập tức sẽ tốt hơn nhiều.
4. Biến môi trường không hiệu lực: Chạy được local nhưng thất bại hoàn toàn trên môi trường production
Trong Node/Python, phổ biến nhất là ENV không được tiêm, container không khởi động lại, hoặc tên biến bị sai chính tả trong CI. Bạn có thể tham khảo cách tiếp cận gỡ lỗi của một số công cụ phụ thuộc: đầu tiên xác nhận "key có thực sự được đọc không", sau đó mới xem xét mạng và code.
5. Hạn chế mạng và khu vực: Lỗi 403 khó giải quyết
Proxy công ty, lối ra máy chủ đám mây, chính sách khu vực đều có thể làm cho request trông "như không có quyền". Thứ tự kiểm tra tôi thường làm như sau:
- Trên cùng một máy, thử curl trực tiếp có thành công không
- Chuyển đổi mạng hoặc nút lối ra và thử lại
- Kiểm tra xem Header có bị WAF/proxy sửa đổi không
Midjourney: Điểm khác biệt nhỏ
Midjourney chủ yếu chạy trong hệ sinh thái Discord, không phải hệ thống API Key truyền thống; những vấn đề bạn gặp thường là do ủy quyền Discord, quyền kênh hoặc bot không khả dụng. Cách tiếp cận vẫn giống: sử dụng các bước tối thiểu để tái hiện, kiểm tra quyền trước rồi mới đến mạng.
Nếu bạn đang vật lộn với các vấn đề "huyền bí" hơn như đăng ký, nút mạng, khu vực tài khoản, đề xuất ghé thăm Titikey, nhiều rắc rối có thể được vượt qua bằng một giải pháp tiện lợi hơn.
