CLOVA Voice 개요

Prev Next

아름다운 성우의 목소리로 글을 읽어주는 애플리케이션을 만들 때 유용한 서비스입니다. CLOVA Voice 는 도메인에 대한 제약없이 자연스러운 합성음을 생성할 수 있습니다.

공통 설정

클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

  1. 콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

  2. AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

  3. AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 CLOVA Voice가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API URL

Method Request URI
POST https://naveropenapi.apigw-pub.fin-ntruss.com/tts-premium/v1/tts

요청 헤더

헤더명 설명
X-NCP-APIGW-API-KEY-ID 앱 등록 시 발급받은 Client ID
X-NCP-APIGW-API-KEY-ID:{Client ID}
X-NCP-APIGW-API-KEY 앱 등록 시 발급 받은 Client Secret
X-NCP-APIGW-API-KEY:{Client Secret}
Content-Type application/x-www-form-urlencoded로 고정
Content-Type: application/x-www-form-urlencoded

오류 코드

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

공통 오류

HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) 등 request 오류
401 200 Authentication Failed 인증실패
401 210 Permission Denied 권한없음
404 300 Not Found Exception 권한없음
429 400 Quota Exceeded Quota 초과
429 420 Rate Limited Rate 초과
413 430 Request Entity Too Large content-length 초과 (10MB)
503 500 Endpoint Error 엔드포인트 연결오류
504 510 Endpoint Timeout 엔드포인트 연결시간 초과
500 900 Unexpected Error 예외처리가 안된 오류

API 오류

HttpStatusCode ErrorCode ErrorMessage Description
400 VS01 speaker parameter is needed. speaker 파라미터 누락
400 VS02 Unsupported speaker. 지원하지 않는 speaker 파라미터
400 VS03 Speed parameter is needed. speed 파라미터 누락
400 VS04 Unsupported speed. 지원하지 않는 speed 파라미터
400 VS05 text parameter is needed. text 파라미터 누락
400 VS06 text parameter exceeds max length. text 파라미터 입력 글자수 초과
400 VS07 Unsupported volume. 지원하지 않는 볼륨
400 VS08 Unsupported pitch. 지원하지 않는 피치
400 VS09 Unsupported alpha. 지원하지 않는 음색
400 VS10 Text parameter check. 합성할 수 없는 text 존재
400 VS11 Unsupported format. 지원하지 않는 포맷
400 VS14 Unsupported emotion value. 지원하지 않는 감정 파라미터
400 VS18 Text parameter exceeds max length per sentence. 문장당 최대 길이(200자) 초과
400 VS19 Unsupported emotion-strength. 지원하지 않는 감정 강도
400 VS26 Failed to make tts. TTS 생성 실패
400 VS46 Unsupported end-pitch. 지원하지 않는 끝음 처리
500 VS99 Internal server error 서버 내부 오류 발생
고객지원 문의 필요