リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
POST	/tts

リクエストヘッダ

CLOVA Voice APIで共通して使用されるヘッダの詳細は、CLOVA Voiceの共通ヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`speaker`	String	Required	音声の合成時に使用するボイスの種類各ボイスに関する情報は音声合成ボイスリストを参照
`text`	String	Required	音声変換対象のテキスト UTF-8エンコードされたテイストのみサポート最大2,000文字まで音声を合成記号や括弧内のテキストは変換しない
`volume`	Integer	Optional	音量 `-5`~`5` (デフォルト: `0`) `-5`: 0.5倍小さく合成 `0`: 正常な音量で合成 `5`: 1.5倍大きく合成
`speed`	Integer	Optional	音声のスピード `-5`~`5` (デフォルト: `0`) `-5`: 2倍速く合成 `0`: 正常なスピードで合成 `5`: 0.5倍遅く合成
`pitch`	Integer	Optional	音声の高低 `-5`~`5` (デフォルト: `0`) `-5`: 1.2倍高く合成 `0`: 正常な高低で合成 `5`: 0.8倍低く合成
`emotion`	Integer	Optional	音声の感情の程度サポートするボイス: `nara` \| `vara` \| `vmikyung` \| `vdain` \| `vyuna` \| `vgoeun` \| `vdaeseong` 各ボイスに関する情報は音声合成ボイスリストを参照 `0`~`3` (デフォルト: `0`) `0`: 中立 `1`: 悲しみ `2`: 喜び `3`: 怒り(`nara`はサポートしない)
`emotion-strength`	Integer	Optional	音声の感情の強度サポートするボイス: `vara` \| `vmikyung` \| `vdain` \| `vyuna` \| `vgoeun` \| `vdaeseong` ;各ボイスに関する情報は音声合成ボイスリストを参照 `0`~`2` (デフォルト: `1`) `0`: 弱 `1`: 普通 `2`: 強
`format`	String	Optional	音声ファイル形式 `mp3`(デフォルト) \| `wav`
`sampling-rate`	Integer	Optional	音声のサンプリングレート `wav`形式のみサポート `8000` \| `16000` \| `24000`(デフォルト)\| `48000` 例外として`mijin`は`mp3`形式に`16000`レートをサポート
`alpha`	Integer	Optional	音色 `-5`~`5` (デフォルト: `0`) `0`より大きい場合: 高い音色 `0`より小さい場合: 低い音色
`end-pitch`	Integer	Optional	音声の終音処理サポートするボイス: `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'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
レスポンスされた TTSオーディオ	Binary	-	MP3または WAV形式のバイナリ音声データ

レスポンスステータスコード

CLOVA Voice APIで共通して使用されるレスポンスステータスコードの詳細は、CLOVA Voiceの共通レスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{MP3または WAV形式のバイナリ音声データ}

この記事は役に立ちましたか?

リクエスト
レスポンス

タグ

CLOVA Voice