---
title: "CLOVA Voice overview"
slug: "ai-naver-clovavoice"
tags: ["CLOVA Voice"]
updated: 2026-09-17T09:35:47Z
published: 2026-09-17T09:35:47Z
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 overview

Available in Classic and VPC

CLOVA Voice is a NAVER Cloud Platform service that provides various natural and high-quality voice synthesis features. The CLOVA Voice service provides APIs for Text-to-Speech (TTS) features in RESTful form.

## Common CLOVA Voice settings

The following describes commonly used request and response formats in CLOVA Voice APIs.

### Request

The following describes the common request format.

#### API URL

The request API URL is as follows.

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

#### Request headers

The following describes the headers.

| Field | Required | Description |
| --- | --- | --- |
| `x-ncp-apigw-api-key-id` | Required | Client ID issued after application registration in NAVER Cloud Platform console |
| `x-ncp-apigw-api-key` | Required | Client secret issued after application registration in NAVER Cloud Platform console |
| `Content-Type` | Required | Request data format - `application/x-www-form-urlencoded` |

              Note

              

For information on how to register an application in the NAVER Cloud Platform console to obtain authentication information (client ID, client secret) required to use the API, see [CLOVA Voice User Guide](https://guide.ncloud-docs.com/docs/en/clovavoice-start). In the console, make sure that the API you want to use after registering the application is selected by clicking the **[Edit]** button. If it is not selected, you will receive a 429 (Quota Exceed) error.

### Response

The following describes the common response format.

#### Response status codes

The following describes the response status codes.

| HTTP status code | Code | Message | Description |
| --- | --- | --- | --- |
| 400 | VS01 | speaker parameter is needed. | `speaker` parameter not entered |
| 400 | VS02 | Unsupported speaker. | Unsupported `speaker` parameter |
| 400 | VS03 | Speed parameter is needed. | `speed` parameter not entered |
| 400 | VS04 | Unsupported speed. | Unsupported `speed` parameter |
| 400 | VS05 | text parameter is needed. | `text` parameter not entered |
| 400 | VS06 | text parameter exceeds max length. | Too many characters in `text` parameter |
| 400 | VS07 | Unsupported volume. | Entered volume (`volume`) parameter not supported |
| 400 | VS08 | Unsupported pitch. | Entered pitch (`pitch`) parameter not supported |
| 400 | VS09 | Unsupported alpha. | Entered tone (`alpha`) parameter not supported |
| 400 | VS10 | Text parameter check. | Entered sentence (`text`) parameter value not synthesizable |
| 400 | VS11 | Unsupported format. | Entered format (`format`) parameter not supported |
| 400 | VS14 | Unsupported emotion value. | Entered emotion (`emotion`) parameter not supported |
| 400 | VS18 | Text parameter exceeds max length per sentence. | Maximum length per sentence exceeded (200 characters) |
| 400 | VS19 | Unsupported emotion-strength. | Entered emotion strength (`emotion-strength`) parameter not supported |
| 400 | VS26 | Failed to make tts. | TTS creation failed |
| 400 | VS46 | Unsupported end-pitch. | Entered end-pitch processing (`end-pitch`) parameter not supported |
| 500 | VS99 | Internal server error | Internal server error - Contact Support |

              Note

              

For response status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

## CLOVA Voice API

The following describes the APIs provided by the CLOVA Voice service.

| API | Description |
| --- | --- |
| [TTS (Preminum)](/docs/en/ai-naver-clovavoice-ttspremium) | Synthesize text to speech |

## CLOVA Voice related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand CLOVA Voice APIs.

- CLOVA Voice API guides
  - [API overview](/docs/en/common-ncpapi): how to issue and check access key and secret key issued by NAVER Cloud Platform, how to generate the signature required for request headers
  - [API Gateway User Guide](https://guide.ncloud-docs.com/docs/en/apigw-apigw-1): how to check the API key required for the request header
  - [Common Ncloud response status codes](/docs/en/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): information on common response status codes of NAVER Cloud Platform used by the CLOVA Voice service
- How to use the CLOVA Voice service
  - [CLOVA Voice User Guide](https://guide.ncloud-docs.com/docs/en/clovavoice-overview): how to use CLOVA Voice in the NAVER Cloud Platform console
  - [Ncloud use environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): guide for VPC and Classic environments and support availability
  - [Introduction to pricing, characteristics, and detailed features](https://www.ncloud.com/product/aiService/clovaVoice): the summary of pricing system, characteristics, and detailed features of CLOVA Voice
  - [Latest service news](https://www.ncloud.com/intro/news): the latest news on CLOVA Voice
  - [FAQ](https://www.ncloud.com/support/faq/prod?categoryCode2=APP&categoryCode3=SV_0067): frequently asked questions from CLOVA Voice users
  - [Contact Us](https://www.ncloud.com/support/question/service): Send direct inquiries in case of any unresolved questions that aren't answered by the user guides.