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

공통 설정

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

콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록해주십시오. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인해주십시오.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 CLOVA Voice가 선택되어 있는지 확인해주십시오. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

Method	Request URI
POST	`https://naveropenapi.apigw.gov-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	예외처리가 안된 오류

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	VS01	speaker parameter is needed.	speaker 파라미터가 누락됨
400	VS02	Unsupported speaker.	speaker 파라미터에 지원하지 않는 값이 입력된 경우 발생
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	VS10	text parameter check.	text 파라미터 확인 바람
400	VS11	Unsupported format.	지원하지 않는 포맷
400	VS14	Unsupported emotion value.	유효한 emotion 값이 아님
500	VS99	Internal server error	서버 내부 오류 발생 고객지원을 통해 문의 시 신속히 조치 예정