Mã lỗi API APIVN và cách xử lý

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`	Mô hình không thuộc nhóm của khoá, hoặc nhà cung cấp lỗi, quá tải	Soát model ID và nhóm khoá; nếu đúng cả 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.

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): mô hình không thuộc nhóm của khoá. Đổi mô hình hoặc tạo khoá đúng nhóm.
model_not_found: model ID sai chính tả, chưa mở bán hoặc không thuộc nhóm của khoá. Tra ở Mô hình.

Gửi mã request lấy từ Nhật ký API, 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.