CLOVA Voice 개요

Article Summary

Share feedback

Thanks for sharing your feedback!

아름다운 성우의 목소리로 글을 읽어주는 애플리케이션을 만들 때 유용한 서비스입니다. 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-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	예외처리가 안된 오류

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	서버 내부 오류 발생 고객지원 문의 필요

이 문서가 도움이 되었습니까?

태그