Skip to main content
이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
Supertone API는 표준 HTTP 상태 코드를 사용합니다. 오류 발생 시 문제를 설명하는 JSON 본문이 반환되며, SDK는 이를 타입이 지정된 예외로 노출하므로 손쉽게 캐치하여 처리할 수 있습니다.

상태 코드 레퍼런스

SDK 오류 클래스

두 SDK 모두 각 상태 코드를 타입이 지정된 오류 클래스로 매핑합니다. 문자열을 파싱하는 것보다 특정 클래스를 캐치하는 방식이 더 명확합니다.
모든 SDK 오류는 다음 속성을 노출합니다.

오류별 대응 방법

4xx — 클라이언트 측

5xx — 서버 측

자주 발생하는 케이스

  • POST 요청에 Content-Type: application/json 누락400 발생.
  • 복사/붙여넣기 과정에서 흔히 발생하는 API Key의 앞뒤 공백으로 인해 401 발생.
  • 다른 계정의 커스텀 보이스 호출 시, ID를 “알고 있다”고 해도 403 발생.
  • raw API에 text를 300자 초과로 전송 시 400 발생. 더 긴 텍스트는 SDK를 사용해 자동 청크 분할하세요.

관련 문서

재시도와 백오프

4295xx에 대한 올바른 재시도 정책을 확인하세요.

요청 수 제한

계정 티어별 제한을 확인하세요.