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
|
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.
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
|
For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.
CLOVA Voice API
The following describes the APIs provided by the CLOVA Voice service.
| API | Description |
|---|---|
| TTS (Preminum) | 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: 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: how to check the API key required for the request header
- Common Ncloud response status codes: 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: how to use CLOVA Voice in the NAVER Cloud Platform console
- Ncloud use environment guide: guide for VPC and Classic environments and support availability
- Introduction to pricing, characteristics, and detailed features: the summary of pricing system, characteristics, and detailed features of CLOVA Voice
- Latest service news: the latest news on CLOVA Voice
- FAQ: frequently asked questions from CLOVA Voice users
- Contact Us: Send direct inquiries in case of any unresolved questions that aren't answered by the user guides.