오류 처리 및 응답 스키마

OneASR은 표준 HTTP 상태 코드와 함께 OpenAI 호환 JSON 오류 본문을 반환합니다.

---

오류 응답 형식

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

---

주요 HTTP 상태 코드

상태 코드	코드 / 타입	설명
200 OK	-	요청이 성공적으로 처리되었습니다.
400 Bad Request	invalid_request_error	필수 파라미터 누락 또는 지원되지 않는 오디오 형식입니다.
401 Unauthorized	invalid_api_key	Authorization 헤더의 API 키가 누락되었거나 유효하지 않습니다.
404 Not Found	not_found_error	요청한 작업 ID 또는 모델을 찾을 수 없습니다.
422 Unprocessable	validation_error	Multipart 폼 스키마 유효성 검사에 실패했습니다.
500 Internal Server	server_error	ASR 추론 워커 오류 또는 메모리 부족(OOM) 예외가 발생했습니다.