Lỗi

Cấu trúc của một response lỗi từ MasterOS API.

Các response lỗi là JSON với một cấu trúc nhất quán:

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Daily quota exceeded",
    "retryable": false
  }
}

code là một chuỗi ổn định, máy có thể đọc được — an toàn để rẽ nhánh xử lý trong code client. message là văn bản dành cho người đọc và cách diễn đạt có thể thay đổi theo thời gian. Một số code bạn sẽ gặp trong thực tế hôm nay: RATE_LIMITED, MODEL_NOT_ALLOWED, CONVERSATION_NOT_FOUND, QUOTA_EXCEEDED, INVALID_REQUEST, FILE_REQUIRED, UNSUPPORTED_FILE_TYPE, FILE_SCAN_FAILED, FILE_NOT_FOUND, PLAN_NOT_FOUND, PLAN_NOT_PURCHASABLE.

Một request chat thất bại không bao giờ stream nguyên văn thông điệp lỗi của provider hay lỗi nội bộ về cho client — bạn sẽ nhận được một thông điệp chung chung cùng một reference id, với chi tiết thật được ghi log ở phía server.