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より小さい場合: 低い終音

    音声合成ボイスリスト

    音声の合成に使用されるボイスの種類の詳細説明は次の通りです。

    フィールド名前言語説明
    carmenカルメンスペイン語女性
    chiahuaチャファ台湾語女性
    claraクララ英語女性
    dannaアンナ英語女性
    dara_angアラ(怒り)韓国語女性
    dara-dannaアラ&アンナ韓国語+英語(米国)女性
    dayumuアユム日本語男性
    ddaikiダイキ日本語男性
    derikoエリコ日本語女性
    dhajimeハジメ日本語男性
    djoeyジョイ英語女性
    dmioミオ日本語女性
    dnaomi_formalナオミ(ニュース)日本語女性
    dnaomi_joyfulナオミ(喜び)日本語女性
    dnaomiナオミ日本語女性
    drikoリコ日本語女性
    dsayuriサユリ日本語女性
    dsinu-mattシヌ&マット韓国語+英語(米国)男性
    dtomokoトモコ日本語女性
    jinhoジノ韓国語男性
    joseホセスペイン語男性
    kuanlinグァンリン台湾語男性
    liangliangリャンリャン中国語男性
    mattマット英語男性
    meimeiメイメイ中国語女性
    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チェ・ムビ韓国語男性
    nnaomiナオミ日本語女性
    nnaraeナレ韓国語女性
    noyjボムダル韓国語女性
    nraewonレウォン韓国語男性
    nreviewパク・リビュ韓国語男性
    nsabina魔女サビナ韓国語女性
    nsangdoサンド韓国語男性
    nsayuriサユリ日本語女性
    nseonghoonソンフン韓国語男性
    nseungpyoスンピョ韓国語男性
    nshashaシャシャ韓国語女性
    nsinuシヌ韓国語男性
    nsiyoonシユン韓国語男性
    nsujinスジン韓国語女性
    nsunheeソニ韓国語女性
    nsunkyungソンギョン韓国語女性
    ntaejinテジン韓国語男性
    ntiffanyギソ韓国語女性
    ntomokoトモコ日本語女性
    nwontakウォンタク韓国語男性
    nwoofわんこ韓国語子供(男)
    nwoosikウシク韓国語男性
    nyejiイェジ韓国語女性
    nyejinイェジン韓国語女性
    nyounghwaチョン・ヨンファ韓国語女性
    nyoungilヨンイル韓国語男性
    nyoungmiヨンミ韓国語女性
    nyujinユジン韓国語女性
    nyunaユナ韓国語女性
    shinjiシンジ日本語男性
    varaアラ(Pro)韓国語女性
    vdaeseongデソン(Pro)韓国語男性
    vdainダイン(Pro)韓国語女性
    vdonghyunドンヒョン(Pro)韓国語男性
    vgoeunゴウン(Pro)韓国語女性
    vhyeriヘリ(Pro)韓国語女性
    vianイアン(Pro)韓国語男性
    vmikyungミギョン(Pro)韓国語女性
    vyunaユナ(Pro)韓国語女性

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    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.