Lập trình tích hợp API của ChatGPT, Claude, Gemini hay sử dụng Midjourney để tạo ảnh, điều khó chịu nhất không phải là không biết dùng mà là gặp lỗi với thông báo không rõ ràng. Tôi đã tổng hợp các lỗi phổ biến nhất theo triệu chứng thành một danh sách kiểm tra, bạn chỉ cần làm theo là có thể xác định được vấn đề.
Lỗi 1: Invalid API key 401 - Xác thực thất bại
Trường hợp này thường không phải do bạn gõ nhầm mà là dùng sai "chìa khóa".
- Xác nhận dùng đúng Key của nền tảng: OpenAI, Anthropic, Google mỗi bên có Key riêng, đừng dùng lẫn lộn.
- Loại bỏ khoảng trắng và xuống dòng thừa: Khi sao chép vào biến môi trường, rất dễ dính phải ký tự xuống dòng.
- Kiểm tra địa chỉ yêu cầu và Header: Ghi sai base_url, thiếu "Bearer" trong Authorization đều sẽ bị từ chối ngay.
- Quyền hạn và hạn mức: Một số model cần được kích hoạt riêng; tài khoản hết tiền hoặc chưa liên kết hóa đơn cũng có thể báo "Key không hợp lệ".
Lỗi 2: 403 429 - Truy cập bị hạn chế hoặc vượt quá tần suất
Tôi thường nghi ngờ mạng và khu vực trước, sau đó mới xem xét liệu code có vòng lặp vô tận không.
- 403 do khu vực hoặc kiểm soát rủi ro: Hãy thử đổi môi trường mạng ổn định, tránh chuyển đổi IP liên tục; mạng doanh nghiệp/học đường cũng dễ bị chặn.
- 429 do gửi yêu cầu quá nhanh: Thêm cơ chế thử lại với độ trễ tăng dần (ví dụ: chờ 1s, 2s, 4s), đừng mở hết công suất xử lý đồng thời.
Lỗi 3: ETARGET, ERESOLVE, ENOTEMPTY khi cài đặt plugin
Nhiều người cài đặt các package phụ thuộc để tích hợp bot hoặc workflow, nhưng lại kẹt ở trình quản lý package, phát cáu muốn đập bàn phím.
- ETARGET: Số phiên bản không tồn tại, hãy đổi sang phiên bản đã phát hành thực tế hoặc nâng cấp npm/yarn của bạn.
- ERESOLVE: Xung đột phụ thuộc, thử xóa file lock và cài lại, cần thiết thì dùng legacy-peer-deps.
- ENOTEMPTY: Thư mục chưa được xóa sạch, xóa thư mục node_modules rồi cài đặt lại là sẽ ổn.
Sự cố thường gặp trên Midjourney: Interaction failed hoặc xếp hàng quá lâu
- Interaction failed: Thường xảy ra khi mạng không ổn định hoặc Discord bị lag, hãy thử gửi lại lệnh hoặc chuyển sang kênh khác.
- Xếp hàng / Giới hạn tốc độ: Giờ cao điểm đừng cố, hãy giảm tác vụ đồng thời hoặc điều chỉnh nhịp độ tạo ảnh "thoáng" hơn.
Nếu bạn vẫn đang mất công tìm kiếm khắp nơi về tài khoản, kênh đăng ký, đường dẫn công cụ, thì có thể ghé thăm Titikey. Ở đó đã tổng hợp sẵn các công cụ AI thông dụng và giải pháp, giúp bạn tiết kiệm thời gian để tạo thêm nhiều ảnh đẹp.
