MENU
      TTS (Premium)

        TTS (Premium)


        Article summary

        Available in Classic and VPC

        Synthesize speech by taking in text to convert and parameters like tone, speed, and emotion.

        Request

        This section describes the request format. The method and URI are as follows:

        MethodURI
        POST/tts

        Request headers

        For information about the headers common to all CLOVA Voice APIs, see Common CLOVA Voice headers.

        Request body

        You can include the following data in the body of your request:

        FieldTypeRequiredDescription
        speakerStringRequiredVoice type to use for speech synthesis
        textStringRequiredText to be converted to speech
        • Only support UTF-8-encoded text
        • Synthesize speech up to 2000 characters
        • Text in symbols or parentheses is not converted
        volumeIntegerOptionalSpeech volume
        • -5 - 5 (default: 0)
          • -5: Synthesize 0.5x smaller
          • 0: Synthesize to normal volume
          • 5: Synthesize 1.5x larger
        speedIntegerOptionalSpeech speed
        • -5 - 5 (default: 0)
          • -5: Synthesize 2x faster
          • 0: Synthesize to normal speed
          • 5: Synthesize 0.5x slower
        pitchIntegerOptionalSpeech pitch
        • -5 - 5 (default: 0)
          • -5: Synthesize 1.2x higher
          • 0: Synthesize to normal pitch
          • 5: Synthesize 0.8x lower
        emotionIntegerOptionalEmotion level of speech
        • Supported voices: nara | vara | vmikyung | vdain | vyuna | vgoeun | vdaeseong
        • 0 - 3 (default: 0)
          • 0: neutral
          • 1: sad
          • 2: happy
          • 3: angry (nara not supported)
        emotion-strengthIntegerOptionalEmotion intensity of speech
        • Supported voices: vara | vmikyung | vdain | vyuna | vgoeun | vdaeseong
        • 0 - 2 (default: 1)
          • 0: weak
          • 1: normal
          • 2: strong
        formatStringOptionalSpeech file format
        • mp3 (default) | wav
        sampling-rateIntegerOptionalSampling rate of speech
        • Only supported for wav format
        • 8000 | 16000 | 24000 (default)| 48000
          • Exceptionally, mijin supports the 16000 rate for mp3 format
        alphaIntegerOptionalTone
        • -5 - 5 (default: 0)
          • If higher than 0: high tone
          • If lower than 0: low tone
        end-pitchIntegerOptionalEnd-pitch processing of speech
        • Supported voices: clara | matt | meimei | liangliang | chiahua | kuanlin | carmen | jose | all voices starting with d- (<e.g.> dara)
        • -5 - 5 (default: 0)
          • If higher than 0: high end-pitch
          • If lower than 0: low end-pitch

        List of speech synthesis voices

        The following describes in detail the types of voices that will be used for speech synthesis.

        FieldNameLanguageDescription
        dara_angAra (angry)KoreanFemale
        jinhoJinhoKoreanMale
        mijinMijinKoreanFemale
        nappleNeulbomKoreanFemale
        nara_callAra (agent)KoreanFemale
        naraAraKoreanFemale
        nboraBoraKoreanFemale
        ndaeseongDaeseongKoreanMale
        ndainDainKoreanChild (female)
        ndonghyunDonghyunKoreanMale
        nes_c_hyeriHyeriKoreanFemale
        nes_c_kihyoKihyoKoreanMale
        nes_c_mikyungMikyungKoreanFemale
        nes_c_sohyunSohyunKoreanFemale
        neunseoEunseoKoreanFemale
        neunwooEunwooKoreanMale
        neunyoungEunyoungKoreanFemale
        ngaramGaramKoreanChild (female)
        ngoeunGoeunKoreanFemale
        ngyeongjunGyeongjunKoreanMale
        nhajunHajunKoreanChild (male)
        nheeraHeeraKoreanFemale
        nianIanKoreanMale
        nihyunIhyunKoreanFemale
        njaewookJaewookKoreanMale
        njangjDreamKoreanFemale
        njihunJihunKoreanMale
        njihwanJihwanKoreanMale
        njinhoJinhoKoreanMale
        njiwonJiwonKoreanFemale
        njiyunJiyunKoreanFemale
        njonghyeokJonghyeokKoreanMale
        njonghyunJonghyunKoreanMale
        njooahnJooahnKoreanMale
        njoonyoungJoonyoungKoreanMale
        nkitaeKitaeKoreanMale
        nkyungleeKyungleeKoreanFemale
        nkyungtaeKyungtaeKoreanMale
        nkyuwonKyuwonKoreanMale
        nmammonDemon MammonKoreanMale
        nmeowMeowKoreanChild (female)
        nmijinMijinKoreanFemale
        nminjeongMinjeongKoreanFemale
        nminsangMinsangKoreanMale
        nminseoMinseoKoreanFemale
        nminyoungMinyoungKoreanFemale
        nmovieMovie ChoiKoreanMale
        noyjBomdalKoreanFemale
        nraewonRaewonKoreanMale
        nreviewReview ParkKoreanMale
        nsabinaWitch SabinaKoreanFemale
        nsangdoSangdoKoreanMale
        nseonghoonSeonghoonKoreanMale
        nseungpyoSeungpyoKoreanMale
        nshashaShashaKoreanFemale
        nsinuSinuKoreanMale
        nsiyoonSiyoonKoreanMale
        nsujinSujinKoreanFemale
        nsunheeSunheeKoreanFemale
        nsunkyungSunkyungKoreanFemale
        ntaejinTaejinKoreanMale
        ntiffanyKiseoKoreanFemale
        nwontakWontakKoreanMale
        nwoofWoofKoreanChild (male)
        nwoosikWoosikKoreanMale
        nyejiYejiKoreanFemale
        nyejinYejinKoreanFemale
        nyounghwaMovie JeongKoreanFemale
        nyoungilYoungilKoreanMale
        nyoungmiYoungmiKoreanFemale
        nyujinYujinKoreanFemale
        nyunaYunaKoreanFemale
        varaAra (Pro)KoreanFemale
        vdaeseongDaeseong (Pro)KoreanMale
        vdainDain (Pro)KoreanFemale
        vdonghyunDonghyun (Pro)KoreanMale
        vgoeunGoeun (Pro)KoreanFemale
        vhyeriHyeri (Pro)KoreanFemale
        vianIan (Pro)KoreanMale
        vmikyungMikyung (Pro)KoreanFemale
        vyunaYuna (Pro)KoreanFemale
        dara-dannaAra & AnnaKorean + English (U.S.)Female
        dsinu-mattSinu & MattKorean + English (U.S.)Male
        liangliangLiangliangChineseMale
        meimeiMeimeiChineseFemale
        dayumuAyumuJapaneseMale
        ddaikiDaikiJapaneseMale
        derikoErikoJapaneseFemale
        dhajimeHajimeJapaneseMale
        dmioMioJapaneseFemale
        dnaomi_formalNaomi (news)JapaneseFemale
        dnaomi_joyfulNaomi (happy)JapaneseFemale
        dnaomiNaomiJapaneseFemale
        drikoRikoJapaneseFemale
        dsayuriSayuriJapaneseFemale
        dtomokoTomokoJapaneseFemale
        nnaomiNaomiJapaneseFemale
        nsayuriSayuriJapaneseFemale
        ntomokoTomokoJapaneseFemale
        shinjiShinjiJapaneseMale
        claraClaraEnglishFemale
        dannaAnnaEnglishFemale
        djoeyJoeyEnglishFemale
        mattMattEnglishMale
        carmenCarmenSpanishFemale
        joseJoseSpanishMale
        chiahuaChiahuaTaiwaneseFemale
        kuanlinKuanlinTaiwaneseMale

        Request example

        The request example is as follows:

        curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/tts-premium/v1/tts' \
        --header 'X-NCP-APIGW-API-KEY-ID: {Client ID issued when registering the app}' \
        --header 'X-NCP-APIGW-API-KEY: {Client secret issued when registering the app}' \
        --header 'Content-Type: application/x-www-form-urlencoded' \
        --data-urlencode 'speaker=nara' \
        --data-urlencode 'text=Hello' \
        --data-urlencode 'volume=0' \
        --data-urlencode 'speed=-1' \
        --data-urlencode 'pitch=1' \
        --data-urlencode 'emotion=2' \
        --data-urlencode 'emotion-strength=1' \
        --data-urlencode 'format=wav' \
        --data-urlencode 'sampling-rate=8000' \
        --data-urlencode 'alpha=0' \
        --data-urlencode 'end-pitch=0'
        Shell

        Response

        This section describes the response format.

        Response body

        The response body includes the following data:

        FieldTypeRequiredDescription
        Responded TTS audioBinary-Binary voice data in MP3 or WAV format

        Response status codes

        For information about the HTTP status codes common to all CLOVA Voice APIs, see Common CLOVA Voice response status codes.

        Response example

        The response example is as follows:

        {Binary voice data in MP3 or WAV format}
        Plain text

        Was this article helpful?

        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.