Mã lỗi

Lỗi trả về theo kiểu OpenAI-compatible. Body luôn có object error với type, code, và message:

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_not_found",
    "message": "Model không tồn tại"
  }
}

Không dùng nội dung message để phân loại tự động. Hãy phân loại bằng HTTP status và code.

| HTTP | Code | Cách xử lý | | --- | --- | --- | | 402 | balance_too_low | Số dư không đủ để reserve request. | | 403 | community_not_allowed | Bật allow_community hoặc chọn model Verified/First-party. | | 404 | model_not_found | Kiểm tra tên model và listing. | | 413 | request_too_large | Giảm kích thước request hoặc số token đầu vào. | | 502 | upstream_error | Provider trả lỗi; thử lại có backoff. | | 504 | upstream_timeout | Provider không phản hồi kịp; thử lại có giới hạn. |

Retry

Chỉ retry lỗi tạm thời như 502 và 504. Dùng backoff và idempotency key ở tầng ứng dụng nếu workflow có thể gửi lại request. Không retry mù lỗi 402, 403, 404, hoặc 413.

ModelMart không ghi prompt hoặc response vào log lỗi. Khi liên hệ hỗ trợ, gửi request ID và metadata như model, status, và thời điểm, không gửi nội dung request.