第 3 章 API 詳細
3.6 表音文字列生成
日本語文章の表音文字列を生成します。
日本語以外の文章は未サポートです。
URI /SpeechSynthesis/v1/phonetics HTTP メソッド POST
3.6.1 リクエスト
ヘッダ
名前 値 補足
X-Service-Code FJAI000004-00301
Content-Type application/json;charset=UTF-8
パラメータ なし
メッセージボディ
形式:JSON
名前 説明 型 必須 既定値
message メッセージ object(Message) ◯ -
Message
名前 説明 型 必須 既定値
text テキストを指定します。(仕様) string ◯ -
テキスト仕様
テキストに指定可能な最大サイズは 1000byte です。
先頭と末尾の空白及びタブ文字は削除されます。また、2 つ以上連続した空白とタブ文字の組み合わ せは 1 つの空白に変換されます。
3.6.2レスポンス
ヘッダ
名前 値 補足
Content-Type application/json;charset=UTF-8
メッセージボディ
形式:JSON
名前 説明 型
phonetic_text 表音文字列 string
エラー情報
コード タイトル メッセージ
400 BAD_REQUEST <size> exceeds the maximum length.
※text のサイズ(バイト数)が上限値を超えて い る 場 合 に 本 メ ッ セ ー ジ が 出 力 さ れ ま す 。
<size>は、入力されたテキストのサイズとなり ます。
400 BAD_REQUEST text exceeds the maximum length.
※text のサイズ(バイト数)が上限値を超えて いる場合に本メッセージが出力されます。
3.6.3実行例
例)「音声合成のテストメッセージです。」の表音文字列を取得する。
リクエスト
curl -X POST "https://zinrai-pf.jp-east-1.paas.cloud.global.fujit su.com/SpeechSynthesis/v1/phonetics" -H "X-Access-Token: 00000000 0000000000000000000000000000" -H "X-Service-Code: FJAI000004-0030 1" -H "Content-Type:application/json;charset=UTF-8" -d "{¥"message
¥":{¥"text¥":¥"音声合成のテストメッセージです。¥"}}"
レスポンス
{ "phonetic_text": "オンセーゴ’ーセーノ/テス%トメ’ッセージデス%."}
付録A パラメータ仕様
本書では、API 毎にパラメータを以下のように種別分けしています。
種別 説明
path URI の中で、クエリ文字列以外(リソース名など)で指定する。
値のみで、パラメータ名は記述されない。
例:/Sample/v1/samp_file/0001 query URI の中で、クエリ文字列で指定する
例:/Sample/v1/samp_file/0001?param1=AAA
本 API におけるリクエスト/レスポンスボディの形式は、JSON を基本とします。JSON の場合、本書では、
型について、以下のように表記します。
型 説明
string ダブルクォーテーションで括った文字列
number 数値(整数、浮動小数点数)
boolean 真偽値(true と false)
array ※[]表記 配列
object ※()内にオブジェクト名表記 オブジェクト(キーと値の組の集まり)
付録B 音節記号
音節記号一覧を以下に示します。
音節記号は各音節の発音を表し、カタカナ、無性化記号(%)、鼻濁音化記号(&)から構成されま す。
なお、ユーザ辞書の読み文字への無性化記号、鼻濁音化記号は使用できません。
ア イ ウ エ オ、ヲ
カ キ ク ケ コ キャ キュ キェ キョ
キ% ク%
サ シ ス セ ソ シャ シュ シェ ショ
シ% ス% シュ%
タ チ ツ テ ト チャ チュ チェ チョ
チ% ツ% チュ%
ティ トゥ
ツァ ツィ ツェ ツォ
ナ ニ ヌ ネ ノ ニャ ニュ ニェ ニョ
ハ ヒ フ ヘ ホ ヒャ ヒュ ヒェ ヒョ
ヒ% フ%
ファ フィ フェ フォ
マ ミ ム メ モ ミャ ミュ ミェ ミョ
ヤ ユ ヨ
ラ リ ル レ ロ リャ リュ リェ リョ
ワ ウィ ウェ ウォ
ガ ギ グ ゲ ゴ ギャ ギュ ギェ ギョ
ガ& ギ& グ& ゲ& ゴ& ギャ& ギュ& ギェ& ギョ&
ザ ジ ズ ゼ ゾ ジャ ジュ ジェ ジョ
ダ ヂ ヅ デ ド ヂャ ヂュ ヂェ ヂョ
ディ ドゥ デュ
バ ビ ブ ベ ボ ビャ ビュ ビェ ビョ
パ ピ プ ペ ポ ピャ ピュ ピェ ピョ
ピ% プ%
ン ー
(長音)
ッ (促音)