CLOVA Voice Overview
- Print
- PDF
CLOVA Voice Overview
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
This service is useful when creating an application that can read texts in a beautiful voice actor's voice. CLOVA Voice can produce natural synthetic sounds without domain limitations.
Common settings
Client IDs are issued by registering the application in the NAVER Cloud Platform console.
Register the application at AI·NAVER API > AI·NAVER API > Application in the console. View details >
Select the application registered at AAI·NAVER API > AI·NAVER API > Application to check the client ID and client secret value.
Check if CLOVA Voice has been selected in the Change screen of AI·NAVER API > AI·NAVER API > Application. If it is not selected, then 429 (Quota Exceed) will occur, so please be careful.
API URL
| Method | Request URI |
|---|---|
| POST | https://naveropenapi.apigw.ntruss.com/tts-premium/v1/tts |
Request headers
| Header | Description |
|---|---|
| X-NCP-APIGW-API-KEY-ID | Client ID issued when registering the appX-NCP-APIGW-API-KEY-ID:{Client ID} |
| X-NCP-APIGW-API-KEY | Client secret issued when registering the appX-NCP-APIGW-API-KEY:{Client Secret} |
| Content-Type | Fixed as application/x-www-form-urlencodedContent-Type: application/x-www-form-urlencoded |
Error code
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}
Common errors
| HttpStatusCode | ErrorCode | ErrorMessage | Description |
|---|---|---|---|
| 400 | 100 | Bad Request Exception | Request error such as protocol (https) or encoding (UTF-8) |
| 401 | 200 | Authentication Failed | Authentication failure |
| 401 | 210 | Permission Denied | No permission |
| 404 | 300 | Not Found Exception | No permission |
| 429 | 400 | Quota Exceeded | Quota exceeded |
| 429 | 420 | Rate Limited | Rate exceeded |
| 413 | 430 | Request Entity Too Large | content-length exceeded (10 MB) |
| 503 | 500 | Endpoint Error | Endpoint connection error |
| 504 | 510 | Endpoint Timeout | Endpoint connection time exceeded |
| 500 | 900 | Unexpected Error | Error without exception handling |
API errors
| HttpStatusCode | ErrorCode | ErrorMessage | Description |
|---|---|---|---|
| 400 | VS01 | speaker parameter is needed. | Missing speaker parameter |
| 400 | VS02 | Unsupported speaker. | Unsupported speaker parameters |
| 400 | VS03 | Speed parameter is needed. | Missing speed parameter |
| 400 | VS04 | Unsupported speed. | Unsupported speed parameters |
| 400 | VS05 | text parameter is needed. | Missing text parameter |
| 400 | VS06 | text parameter exceeds max length. | Exceeds the number of text parameter input characters |
| 400 | VS07 | Unsupported volume. | Unsupported volume |
| 400 | VS08 | Unsupported pitch. | Unsupported pitch |
| 400 | VS09 | Unsupported alpha. | Unsupported voice |
| 400 | VS10 | Text parameter check. | Existence of text that cannot be synthesized |
| 400 | VS11 | Unsupported format. | Unsupported format |
| 400 | VS14 | Unsupported emotion value. | Unsupported emotion parameters |
| 400 | VS18 | Text parameter exceeds max length per sentence. | Exceeded the maximum length per sentence (200 characters) |
| 400 | VS19 | Unsupported emotion-strength. | Unsupported intensity of emotion |
| 400 | VS26 | Failed to make tts. | TTS creation failed |
| 400 | VS46 | Unsupported end-pitch. | Unsupported end-pitch |
| 500 | VS99 | Internal server error | Internal server error Requires contacting customer support |
Was this article helpful?