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최무비한국어남성
    nnarae나래한국어여성
    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'
    

    응답

    응답 형식을 설명합니다.

    응답 바디

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

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

    응답 상태 코드

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

    응답 예시

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

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

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

    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.