오류
MasterOS API의 오류 response 형태를 설명합니다.
오류 response는 일관된 형태의 JSON입니다:
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Daily quota exceeded",
"retryable": false
}
}
code는 안정적이고 기계가 읽을 수 있는 문자열입니다 — client 코드에서 분기 처리에 사용해도 안전합니다. message는
사람이 읽기 위한 것이며 문구가 시간이 지나면서 바뀔 수 있습니다. 오늘 실제로 볼 수 있는 code로는 다음이 있습니다:
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.
실패한 채팅 request는 절대 provider의 원문 오류나 내부 오류 메시지를 client로 스트리밍하지 않습니다 — 실제 세부 정보는 서버 측에 로그로 남고, client는 일반적인 메시지와 reference id를 받게 됩니다.