--- title: "CLOVA Voice 개요" slug: "ai-naver-clovavoice" tags: ["CLOVA Voice"] updated: 2026-07-23T09:04:26Z published: 2026-07-23T09:04:26Z canonical: "api.ncloud-docs.com/ai-naver-clovavoice" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # CLOVA Voice 개요 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/x-www-form-urlencoded` | 참고 네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 [CLOVA Voice 사용 가이드](https://guide.ncloud-docs.com/docs/clovavoice-start)를 참조해 주십시오. 콘솔에서 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 응답 상태 코드](/docs/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ## CLOVA Voice API CLOVA Voice 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다. | API | 설명 | | --- | --- | | [TTS (Preminum)](/docs/ai-naver-clovavoice-ttspremium) | 텍스트를 음성으로 합성 | ## CLOVA Voice 연관 리소스 CLOVA Voice API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다. - CLOVA Voice API 사용 방법 - [API 개요](/docs/common-ncpapi): 네이버 클라우드 플랫폼에서 발급받은 Access Key, Secret Key 발급 및 확인, 요청 헤더에 필요한 서명 생성 방법 - [API Gateway 사용 가이드](https://guide.ncloud-docs.com/docs/apigw-apigw-1): 요청 헤더에 필요한 API Key 확인 방법 - [Ncloud 공통 응답 상태 코드](/docs/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): CLOVA Voice 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보 - CLOVA Voice 서비스 사용 방법 - [CLOVA Voice 사용 가이드](https://guide.ncloud-docs.com/docs/clovavoice-overview): 네이버 클라우드 플랫폼 콘솔에서 CLOVA Voice 사용하는 방법 - [Ncloud 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 대한 가이드 - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/aiService/clovaVoice): CLOVA Voice의 요금 체계, 특징, 상세 기능 요약 - [서비스 최신 소식](https://www.ncloud.com/intro/news): CLOVA Voice 관련 최신 소식 - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=APP&categoryCode3=SV_0067): CLOVA Voice 사용자들이 자주 하는 질문 - [문의하기](https://www.ncloud.com/support/question/service): 사용 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의