Xử lý sự cố3 phút đọcCập nhật 04/11/2026
Cẩm nang xử lý sự cố & Lỗi kết nối
Hướng dẫn chẩn đoán và khắc phục nhanh các sự cố thường gặp khi kết nối ứng dụng với APIVIEN.
#troubleshooting#sự cố#lỗi#fix#debug
#Lỗi 1: 'Could not verify API Key' hoặc '401 Unauthorized'
- **Nguyên nhân**: API Key bị dán thừa dấu cách, thiếu tiền tố `Bearer ` trong header, hoặc key đã bị thu hồi trên Dashboard.
- **Khắc phục**: Kiểm tra lại chuỗi key trên Dashboard, đảm bảo sao chép chính xác nguyên vẹn không khoảng trắng ở 2 đầu.
#Lỗi 2: 'Model not found' hoặc '404 Not Found'
- **Nguyên nhân**: Điền sai chính tả mã model ID hoặc model đó tạm thời không khả dụng.
- **Khắc phục**: Vào mục **Models** trên Dashboard hoặc trang [apivien.com/models](https://apivien.com/models) để sao chép chuẩn xác Model ID (ví dụ: `deepseek/deepseek-v3.2`, `claude-3-7-sonnet`).
#Lỗi 3: 'Network error' hoặc '524 Gateway Timeout'
- **Nguyên nhân**: Một số mô hình suy luận (DeepSeek R1, Claude Opus) suy nghĩ lâu hơn 120 giây trước khi hoàn tất toàn bộ câu trả lời, làm proxy mạng trung gian tự động ngắt kết nối.
- **Khắc phục**: **Bật chế độ streaming (`stream: true`)**. Khi bật streaming, các token đầu tiên sẽ được gửi về ngay trong vòng vài giây, duy trì kết nối liên tục và loại bỏ hoàn toàn lỗi 524.