오류 처리 및 상태 코드

OneTTS는 모든 에러 응답을 OpenAI 표준 에러 페이로드 구조에 맞춰 일관되게 반환합니다.

---

🛑 오류 응답 형식

{
  "error": {
    "message": "Incorrect API key provided or missing Authorization header.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  },
  "detail": "Incorrect API key provided or missing Authorization header."
}

---

📊 HTTP 상태 코드

상태 코드	에러 유형 (type)	의미 및 원인
400	invalid_request_error	필수 필드 누락 또는 잘못된 매개변수
401	authentication_error	API 키 누락 또는 인증 실패
404	not_found_error	요청한 리소스 또는 경로를 찾을 수 없음
500	api_error	서버 내부 오류 또는 엔진 합성 실패