Lỗi và gỡ lỗi

RouteAPI cố gắng trả về cấu trúc lỗi thống nhất để giúp client xác định nguồn lỗi và cách xử lý.

Cấu trúc lỗi chuẩn

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Mã trạng thái	Loại	Nguyên nhân thường gặp	Cách xử lý đề xuất
400	Lỗi yêu cầu	Sai định dạng tham số, mô hình không hỗ trợ tham số	Kiểm tra request body và năng lực mô hình
401	Lỗi xác thực	Thiếu Token, Token sai hoặc đã bị xóa	Kiểm tra `Authorization`
402	Lỗi số dư	Số dư người dùng không đủ hoặc quota Token đã hết	Nạp tiền hoặc điều chỉnh quota
404	Lỗi đường dẫn	Endpoint không tồn tại	Kiểm tra URL
429	Giới hạn tần suất	Giới hạn người dùng, Token hoặc hệ thống	Giảm đồng thời hoặc điều chỉnh giới hạn
500	Lỗi hệ thống	Lỗi nội bộ RouteAPI	Xem nhật ký dịch vụ

Xác nhận URL yêu cầu, Token và ID mô hình.
Xác nhận số dư, quota và quyền truy cập của người dùng sở hữu Token.
Xem nhật ký sử dụng trong console để xác nhận yêu cầu có vào RouteAPI hay không.
Nếu là yêu cầu streaming, xác nhận client có xử lý SSE đúng cách hay không.

RouteAPI là hệ thống gateway, lỗi có thể đến từ ba lớp:

Lớp	Ví dụ
Client	JSON request body sai, thiếu Token
RouteAPI	Số dư không đủ, không có quyền
Dịch vụ mô hình	Dịch vụ bị giới hạn, không khả dụng, mô hình bị gỡ

Khi xử lý sự cố trong production, nên đồng thời ghi lại: