Mã HTTP
| Mã | Nghĩa là gì | Làm gì |
|---|---|---|
400 | Yêu cầu sai định dạng | Soát lại model ID, địa chỉ API và cú pháp JSON. |
401 | Khoá thiếu, sai, hết hạn, hết hạn mức hoặc đã bị tắt | Chép lại khoá cho đủ; xem trạng thái và hạn mức của khoá. |
403 | Hết số dư, hoặc khoá bị giới hạn mô hình, nhóm hay IP | Nạp thêm; kiểm tra nhóm và giới hạn mô hình, IP của khoá. |
404 | Sai địa chỉ hoặc endpoint | Kiểu OpenAI dùng https://apivn.vn/v1, kiểu Anthropic dùng https://apivn.vn; đừng để thành /v1/v1. |
413 | Request quá lớn | Cắt bớt lịch sử hội thoại hoặc phần đính kèm. |
429 | Gửi quá dày trong thời gian ngắn | Giãn tần suất, đợi vài giây rồi gửi lại. |
500 | Lỗi phía hệ thống | Thử lại sau; nếu lặp lại, gửi mã request cho hỗ trợ. |
502 / 503 | Gõ nhầm model ID, hoặc nhà cung cấp lỗi, quá tải. Nếu bạn tự tạo khoá gắn nhóm cụ thể thì còn do gọi mô hình ngoài nhóm đó | Soát lại model ID; nếu đúng thì đợi một hai phút rồi thử lại. |
504 | Nhà cung cấp trả lời quá chậm | Bật streaming, rút gọn request rồi thử lại. |
Thông báo hay gặp
- Không đủ số dư / insufficient quota (HTTP 403): nạp thêm rồi gọi lại.
- Không có kênh khả dụng cho mô hình trong nhóm hiện tại (HTTP 503): khoá của bạn không với tới mô hình đó. Khoá Tự động gần như không gặp lỗi này; nếu gặp, kiểm tra xem khoá có bị gắn nhóm cụ thể không.
model_not_found: model ID sai chính tả hoặc chưa mở bán. Tra ở Mô hình.
Khi cần báo lỗi
Gửi mã request lấy từ Nhật ký sử dụng, thời điểm và mô hình cho APIVN qua trang Liên hệ. Đừng ghi log hay gửi nguyên header Authorization.