이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
상태 코드 레퍼런스
SDK 오류 클래스
두 SDK 모두 각 상태 코드를 타입이 지정된 오류 클래스로 매핑합니다. 문자열을 파싱하는 것보다 특정 클래스를 캐치하는 방식이 더 명확합니다.- Python
- TypeScript
오류별 대응 방법
4xx — 클라이언트 측
5xx — 서버 측
자주 발생하는 케이스
- POST 요청에
Content-Type: application/json누락 시400발생. - 복사/붙여넣기 과정에서 흔히 발생하는 API Key의 앞뒤 공백으로 인해
401발생. - 다른 계정의 커스텀 보이스 호출 시, ID를 “알고 있다”고 해도
403발생. - raw API에
text를 300자 초과로 전송 시400발생. 더 긴 텍스트는 SDK를 사용해 자동 청크 분할하세요.
관련 문서
재시도와 백오프
429와 5xx에 대한 올바른 재시도 정책을 확인하세요.요청 수 제한
계정 티어별 제한을 확인하세요.