Câu hỏi thường gặp

Mã	Ý nghĩa	Nguyên nhân thường gặp	Cách xử lý
200	Thành công	Phản hồi bình thường; nếu nội dung rỗng hoặc SSE không có data, có thể sai endpoint	Kiểm tra endpoint tương ứng với model
400	Yêu cầu sai định dạng	JSON không hợp lệ, thiếu trường bắt buộc, sai tên model hoặc tham số vượt giới hạn	Kiểm tra nội dung request và xác thực JSON
401	Chưa xác thực	Thiếu API key, key sai, bị vô hiệu hóa hoặc lỗi mạng	Kiểm tra trạng thái key trong dashboard
403	Không đủ quyền	Không có quyền truy cập model hoặc nhóm token	Kiểm tra quyền nhóm hoặc liên hệ hỗ trợ
404	Không tìm thấy	Sai URL hoặc model không khả dụng	Kiểm tra /v1/models và chính tả URL
413	Nội dung yêu cầu quá lớn	Prompt hoặc input vượt giới hạn context	Rút ngắn input hoặc chia nhỏ xử lý
429	Bị giới hạn / hết quota	QPS quá cao hoặc tài khoản hết số dư/quota	Giảm đồng thời và kiểm tra quota
500	Lỗi nội bộ upstream	Nhà cung cấp model phía trên gặp lỗi	Chờ 30 giây rồi thử lại
502	Lỗi gateway	Kết nối từ gateway tới upstream bất thường	Chờ 1 phút rồi thử lại
503	Dịch vụ không khả dụng	Upstream quá tải hoặc đang bảo trì	Chờ 1-5 phút rồi thử lại
504	Gateway timeout	Upstream phản hồi chậm hoặc prompt quá dài	Rút ngắn input hoặc bật streaming
524	Timeout	Cloudflare timeout	Thử lại nhiều lần