Xử lý sự cố4 phút đọcCập nhật 04/11/2026
Mã lỗi & Best Practices xử lý lỗi
Tra cứu ý nghĩa các mã trạng thái HTTP, cơ chế thử lại tự động (Exponential Backoff) và phòng tránh lỗi kết nối.
#lỗi#error#status code#retry#429#524
#Bảng tra cứu mã lỗi HTTP
| HTTP Code | Loại lỗi | Nguyên nhân | Cách khắc phục |
|---|---|---|---|
| 400 | invalid_request_error | Tham số body không hợp lệ (VD truyền temperature vào model không hỗ trợ) | Kiểm tra lại định dạng JSON và tài liệu tham số của model |
| 401 | authentication_error | API Key không chính xác hoặc thiếu header Authorization | Kiểm tra lại API Key trên Dashboard và tiền tố 'Bearer ' |
| 402 | insufficient_quota | Số dư ví VNĐ không đủ để thực hiện lượt gọi | Nạp thêm tiền vào tài khoản qua VietQR tự động trên Dashboard |
| 404 | model_not_found | Model ID không tồn tại hoặc chưa được kích hoạt | Xem danh sách model ID chuẩn tại trang Models |
| 429 | rate_limit_exceeded | Vượt quá số request/phút (RPM) hoặc token/phút (TPM) | Áp dụng cơ chế Exponential Backoff và Retry sau vài giây |
| 524 | timeout_error | Model suy luận quá lâu vượt 120s dẫn đến ngắt kết nối mạng | Bắt buộc bật 'stream': true khi gọi các model Reasoning |