Khi tích hợp API của ChatGPT, Claude, Gemini vào hệ thống backend, sự cố thường gặp không phải do mô hình kém hiệu quả mà là do lỗi khóa API, mạng không kết nối được, hoặc bị chặn bởi chính sách khu vực. Midjourney dù không sử dụng cơ chế khóa API, nhưng trên Discord cũng có thể gặp thông báo về quyền hạn và hạn mức sử dụng, bản chất đều thuộc dạng: bạn chưa "được cho phép".
Tự kiểm tra 1 phút: 90% lỗi API đều ở đây
- Dán khóa sai: Sao chép thừa khoảng trắng, dòng mới, hoặc dùng nhầm "khóa dự án" thay vì "khóa cá nhân".
- Khóa không đủ quyền hạn: Chưa kích hoạt tính phí/chưa liên kết thẻ, hoặc tổ chức/dự án chưa được cấp quyền truy cập mô hình tương ứng.
- Biến môi trường chưa có hiệu lực: Đã khởi động lại dịch vụ chưa? Cấu hình trong container và máy local có thể khác nhau.
- Bị proxy ảnh hưởng: Có thể mở trang web không đồng nghĩa backend kết nối trực tiếp được đến domain API, nhiều người mắc kẹt ở điểm này.
Xử lý theo thông báo lỗi cụ thể
Thông báo Unauthorized hoặc Invalid API key
Đừng vội đổ lỗi cho nền tảng, hãy vào bảng điều khiển tạo lại khóa mới, khóa cũ nên hủy ngay; sau đó kiểm tra xem trường trong tiêu đề yêu cầu có đúng không. Khi phát triển bot hoặc plugin, ví dụ như một số plugin Koishi thường báo lỗi do tên trường khóa hoặc định dạng dán sai.
Thông báo Rate limit hoặc Quota exceeded
Đây không phải là "hỏng", mà do bạn sử dụng quá tải. Hãy giảm tải đồng thời, thêm cơ chế thử lại với độ trễ; nếu cần ổn định, hãy nâng cấp gói dịch vụ có hạn mức cao hơn. Midjourney khi hết lượt fast cũng tương tự, hãy kiên nhẫn xếp hàng chế độ chậm.
