CLOVA Voice 개요
- 인쇄
- PDF
CLOVA Voice 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
CLOVA Voice는 다양하고 자연스러운 고품질 음성 합성 기능을 제공하는 네이버 클라우드 플랫폼의 서비스입니다. CLOVA Voice 서비스에서는 TTS (Text-to-Speech) 기능에 대한 API를 RESTful 형태로 제공합니다.
CLOVA Voice 공통 설정
CLOVA Voice API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
https://naveropenapi.apigw.ntruss.com/tts-premium/v1
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
x-ncp-apigw-api-key-id | Required | 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID |
x-ncp-apigw-api-key | Required | 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret |
Content-Type | Required | 요청 데이터의 형식
|
참고
네이버 클라우드 플랫폼 콘솔에서 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에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- CLOVA Voice API 사용 방법
- API 개요: 네이버 클라우드 플랫폼에서 발급받은 Access Key, Secret Key 발급 및 확인, 요청 헤더에 필요한 서명 생성 방법
- API Gateway 사용 가이드: 요청 헤더에 필요한 API Key 확인 방법
- Ncloud 공통 응답 상태 코드: CLOVA Voice 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- CLOVA Voice 서비스 사용 방법
- CLOVA Voice 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 CLOVA Voice 사용하는 방법
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 대한 가이드
- 요금 소개, 특징, 상세 기능: CLOVA Voice의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: CLOVA Voice 관련 최신 소식
- 자주 하는 질문: CLOVA Voice 사용자들이 자주 하는 질문
- 문의하기: 사용 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의
이 문서가 도움이 되었습니까?