MENU
      TTS (Premium)
        • PDF

        TTS (Premium)

        • PDF

        기사 요약

        Classic/VPC 환경에서 이용 가능합니다.

        변환할 텍스트와 음색, 속도, 감정 등을 파라미터로 입력받아 음성을 합성합니다.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        메서드URI
        POST/tts

        요청 헤더

        CLOVA Voice API에서 공통으로 사용하는 헤더에 대한 정보는 CLOVA Voice 공통 헤더를 참조해 주십시오.

        요청 바디

        요청 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        speakerStringRequired음성 합성 시 사용할 목소리 종류
        textStringRequired음성으로 변환할 텍스트
        • UTF-8 인코딩된 텍스트만 지원
        • 최대 2,000자까지 음성 합성
        • 기호나 괄호 안의 텍스트는 미변환
        volumeIntegerOptional음성 크기
        • -5~5 (기본값: 0)
          • -5: 0.5배 작게 합성
          • 0: 정상 크기로 합성
          • 5: 1.5배 크게 합성
        speedIntegerOptional음성 속도
        • -5~5 (기본값: 0)
          • -5: 2배 빠르게 합성
          • 0: 정상 속도로 합성
          • 5: 0.5배 느리게 합성
        pitchIntegerOptional음성 높낮이
        • -5~5 (기본값: 0)
          • -5: 1.2배 높게 합성
          • 0: 정상 높낮이로 합성
          • 5: 0.8배 낮게 합성
        emotionIntegerOptional음성의 감정 정도
        • 지원 목소리: nara | vara | vmikyung | vdain | vyuna | vgoeun | vdaeseong
        • 0~3 (기본값: 0)
          • 0: 중립
          • 1: 슬픔
          • 2: 기쁨
          • 3: 분노 (nara 미지원)
        emotion-strengthIntegerOptional음성의 감정 강도
        • 지원 목소리: vara | vmikyung | vdain | vyuna | vgoeun | vdaeseong
        • 0~2 (기본값: 1)
          • 0: 약함
          • 1: 보통
          • 2: 강함
        formatStringOptional음성 파일 형식
        • mp3 (기본값) | wav
        sampling-rateIntegerOptional음성의 샘플링 레이트
        • wav 형식만 지원
        • 8000 | 16000 | 24000 (기본값)| 48000
          • 예외적으로 mijinmp3 형식에 16000 레이트 지원
        alphaIntegerOptional음색
        • -5~5 (기본값: 0)
          • 0보다 클 경우: 높은 음색
          • 0보다 작을 경우: 낮은 음색
        end-pitchIntegerOptional음성의 끝음 처리
        • 지원 목소리: clara | matt | meimei | liangliang | chiahua | kuanlin | carmen | jose | d-로 시작하는 목소리 전체(<예시> dara)
        • -5~5 (기본값: 0)
          • 0보다 클 경우: 높은 끝음
          • 0보다 작을 경우: 낮은 끝음

        음성 합성 목소리 목록

        음성 합성에 사용될 목소리 종류에 대한 상세 설명은 다음과 같습니다.

        필드이름언어설명
        dara_ang아라(화남)한국어여성
        jinho진호한국어남성
        mijin미진한국어여성
        napple늘봄한국어여성
        nara_call아라(상담원)한국어여성
        nara아라한국어여성
        nbora보라한국어여성
        ndaeseong대성한국어남성
        ndain다인한국어아동(여)
        ndonghyun동현한국어남성
        nes_c_hyeri혜리한국어여성
        nes_c_kihyo기효한국어남성
        nes_c_mikyung미경한국어여성
        nes_c_sohyun소현한국어여성
        neunseo은서한국어여성
        neunwoo은우한국어남성
        neunyoung은영한국어여성
        ngaram가람한국어아동(여)
        ngoeun고은한국어여성
        ngyeongjun경준한국어남성
        nhajun하준한국어아동(남)
        nheera희라한국어여성
        nian이안한국어남성
        nihyun이현한국어여성
        njaewook재욱한국어남성
        njangj드림한국어여성
        njihun지훈한국어남성
        njihwan지환한국어남성
        njinho진호한국어남성
        njiwon지원한국어여성
        njiyun지윤한국어여성
        njonghyeok종혁한국어남성
        njonghyun종현한국어남성
        njooahn주안한국어남성
        njoonyoung준영한국어남성
        nkitae기태한국어남성
        nkyunglee경리한국어여성
        nkyungtae경태한국어남성
        nkyuwon규원한국어남성
        nmammon악마 마몬한국어남성
        nmeow야옹이한국어아동(여)
        nmijin미진한국어여성
        nminjeong민정한국어여성
        nminsang민상한국어남성
        nminseo민서한국어여성
        nminyoung민영한국어여성
        nmovie최무비한국어남성
        noyj봄달한국어여성
        nraewon래원한국어남성
        nreview박리뷰한국어남성
        nsabina마녀 사비나한국어여성
        nsangdo상도한국어남성
        nseonghoon성훈한국어남성
        nseungpyo승표한국어남성
        nshasha샤샤한국어여성
        nsinu신우한국어남성
        nsiyoon시윤한국어남성
        nsujin수진한국어여성
        nsunhee선희한국어여성
        nsunkyung선경한국어여성
        ntaejin태진한국어남성
        ntiffany기서한국어여성
        nwontak원탁한국어남성
        nwoof멍멍이한국어아동(남)
        nwoosik우식한국어남성
        nyeji예지한국어여성
        nyejin예진한국어여성
        nyounghwa정영화한국어여성
        nyoungil영일한국어남성
        nyoungmi영미한국어여성
        nyujin유진한국어여성
        nyuna유나한국어여성
        vara아라(Pro)한국어여성
        vdaeseong대성(Pro)한국어남성
        vdain다인(Pro)한국어여성
        vdonghyun동현(Pro)한국어남성
        vgoeun고은(Pro)한국어여성
        vhyeri혜리(Pro)한국어여성
        vian이안(Pro)한국어남성
        vmikyung미경(Pro)한국어여성
        vyuna유나(Pro)한국어여성
        dara-danna아라&안나한국어+영어(미국)여성
        dsinu-matt신우&매트한국어+영어(미국)남성
        liangliang량량중국어남성
        meimei메이메이중국어여성
        dayumu아유무일본어남성
        ddaiki다이키일본어남성
        deriko에리코일본어여성
        dhajime하지메일본어남성
        dmio미오일본어여성
        dnaomi_formal나오미(뉴스)일본어여성
        dnaomi_joyful나오미(기쁨)일본어여성
        dnaomi나오미일본어여성
        driko리코일본어여성
        dsayuri사유리일본어여성
        dtomoko토모코일본어여성
        nnaomi나오미일본어여성
        nsayuri사유리일본어여성
        ntomoko토모코일본어여성
        shinji신지일본어남성
        clara클라라영어여성
        danna안나영어여성
        djoey조이영어여성
        matt매트영어남성
        carmen카르멘스페인어여성
        jose호세스페인어남성
        chiahua차화대만어여성
        kuanlin관린대만어남성

        요청 예시

        요청 예시는 다음과 같습니다.

        curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/tts-premium/v1/tts' \
        --header 'X-NCP-APIGW-API-KEY-ID: {앱 등록 시 발급받은 Client ID}' \
        --header 'X-NCP-APIGW-API-KEY: {앱 등록 시 발급 받은 Client Secret}' \
        --header 'Content-Type: application/x-www-form-urlencoded' \
        --data-urlencode 'speaker=nara' \
        --data-urlencode 'text=안녕하세요 ' \
        --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

        응답

        응답 형식을 설명합니다.

        응답 바디

        응답 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        응답받은 TTS 오디오Binary-MP3 또는 WAV 형식의 바이너리 음성 데이터

        응답 상태 코드

        CLOVA Voice API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 CLOVA Voice 공통 응답 상태 코드를 참조해 주십시오.

        응답 예시

        응답 예시는 다음과 같습니다.

        {MP3 또는 WAV 형식의 바이너리 음성 데이터}
        Plain text

        이 문서가 도움이 되었습니까?

        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.