CLOVA Voice overview
    • PDF

    CLOVA Voice overview

    • PDF

    Article summary

    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.

    FieldRequiredDescription
    x-ncp-apigw-api-key-idRequiredClient ID issued after application registration in NAVER Cloud Platform console
    x-ncp-apigw-api-keyRequiredClient secret issued after application registration in NAVER Cloud Platform console
    Content-TypeRequiredRequest 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.
    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 codeCodeMessageDescription
    400VS01speaker parameter is needed.speaker parameter not entered
    400VS02Unsupported speaker.Unsupported speaker parameter
    400VS03Speed parameter is needed.speed parameter not entered
    400VS04Unsupported speed.Unsupported speed parameter
    400VS05text parameter is needed.text parameter not entered
    400VS06text parameter exceeds max length.Too many characters in text parameter
    400VS07Unsupported volume.Entered volume (volume) parameter not supported
    400VS08Unsupported pitch.Entered pitch (pitch) parameter not supported
    400VS09Unsupported alpha.Entered tone (alpha) parameter not supported
    400VS10Text parameter check.Entered sentence (text) parameter value not synthesizable
    400VS11Unsupported format.Entered format (format) parameter not supported
    400VS14Unsupported emotion value.Entered emotion (emotion) parameter not supported
    400VS18Text parameter exceeds max length per sentence.Maximum length per sentence exceeded (200 characters)
    400VS19Unsupported emotion-strength.Entered emotion strength (emotion-strength) parameter not supported
    400VS26Failed to make tts.TTS creation failed
    400VS46Unsupported end-pitch.Entered end-pitch processing (end-pitch) parameter not supported
    500VS99Internal server errorInternal server error
    • Contact Support
    Note

    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.

    APIDescription
    TTS (Preminum)Synthesize text to speech

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


    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.