CLOVA Voice 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Voice는 다양하고 자연스러운 고품질 음성 합성 기능을 제공하는 네이버 클라우드 플랫폼의 서비스입니다. CLOVA Voice 서비스에서는 TTS (Text-to-Speech) 기능에 대한 API를 RESTful 형태로 제공합니다.

CLOVA Voice 공통 설정

CLOVA Voice API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://naveropenapi.apigw.gov-ntruss.com/tts-premium/v1/tts

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-api-key-id Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID
x-ncp-apigw-api-key Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret
Content-Type Required 요청 데이터의 형식
  • application/x-www-form-urlencoded
참고

네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 CLOVA Voice 사용 가이드를 참조해 주십시오.
콘솔에서 Application 등록 후 사용할 API가 선택되어 있는지 [수정] 버튼을 클릭하여 확인해 주십시오. 선택되어 있지 않으면 429 (Quota Exceed) 오류가 발생합니다.

응답

공통 응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
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. 입력된 볼륨(volume) 파라미터 값을 지원하지 않음
400 VS08 Unsupported pitch. 입력된 높낮이(pitch) 파라미터 값을 지원하지 않음
400 VS09 Unsupported alpha. 입력된 음색(alpha) 파라미터 값을 지원하지 않음
400 VS10 Text parameter check. 입력된 문장(text) 파라미터 값이 합성 불가
400 VS11 Unsupported format. 입력된 형식(format) 파라미터 값을 지원하지 않음
400 VS14 Unsupported emotion value. 입력된 감정(emotion) 파라미터 값을 지원하지 않음
400 VS18 Text parameter exceeds max length per sentence. 문장당 최대 길이(200자) 초과
400 VS19 Unsupported emotion-strength. 입력된 감정 강도(emotion-strength) 파라미터 값을 지원하지 않음
400 VS26 Failed to make tts. TTS 생성 실패
400 VS46 Unsupported end-pitch. 입력된 끝음 처리(end-pitch) 파라미터 값을 지원하지 않음
500 VS99 Internal server error 내부 서버 오류
  • 고객지원 문의
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

CLOVA Voice API

CLOVA Voice 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
TTS (Preminum) 텍스트를 음성으로 합성

CLOVA Voice 연관 리소스

CLOVA Voice API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.