Lỗi trả về theo định dạng mà SDK của bạn đọc được (OpenAI, Anthropic hoặc Gemini), kèm error.code và error.message dễ đọc.
Chỉ thử lại với lỗi 429 và 5xx, có giãn cách giữa các lần. Đừng tự gửi lại khi stream đã trả một phần nội dung.
Điểm cần nhớ
- 400/422: request hoặc trường dữ liệu không hợp lệ.
- 401: khóa API không hợp lệ, đã thu hồi hoặc hết hạn.
- 402: số dư ví không đủ; hãy nạp thêm tiền.
- 403: khóa API không được dùng model này hoặc bị giới hạn IP.
- 429: vượt giới hạn tốc độ; chờ một chút rồi thử lại.
- 502/503: model tạm thời gián đoạn; thử lại sau ít giây.
- Stream có thể trả một sự kiện lỗi hoặc ngắt trước [DONE]; hãy giữ phần đã nhận và báo lỗi cho người dùng.