登録単語を利用する方法

事前に登録しておく方法で単語をプロファイルに保存した場合に、その単語を有効にする方法を説明します。

利用方法

音声認識のリクエストパラメータに、音声認識エンジン(grammarFileNames)に加えて、プロファイルID(profileId)を設定します。そのリクエストのセッション中はプロファイルに登録した単語が有効になります。

grammarFileNames={接続エンジン名} profileId=:{プロファイルID}

profileIdには「:」（半角コロン）に続けてプロファイルの名前を指定してください。
プロファイルは音声認識エンジンごとに区別されているので、単語登録したときに指定したgrammarFileNamesをリクエスト時にも設定してください。
マイページから登録した場合は、プロファイルIDにサービスIDを設定してください。

ヒント

profileId の先頭に「:」をつけなくても動作します。ただし、以下のような理由により、意図せぬ内容でプロファイルが保存されて認識精度が低下する可能性があります。

「:」をつけない場合、音声認識処理のセッション終了時に、そのセッションで使用されたプロファイルの内容でプロファイルが上書きされます。
たとえば、testというプロファイルを使って音声認識処理を実行している最中に、別途、単語登録 API でtestプロファイルの内容を更新したとします。この場合、音声認識のセッション終了時に、testプロファイルは「音声認識処理で使用された内容」＝「単語登録 API で更新する前の内容」で上書きされ、ロールバックされてしまいます。

もし、profileIdとprofileWordsを同時に指定した場合は、profileWordsが優先されます。すでにプロファイルに登録されている単語は有効にはなりません。

例えば、以下のように「会話_汎用エンジン」(-a-general)で、profileIdに「:test」、profileWordsに「AMI あみ」と設定してリクエストを行ったとします。このときのセッションでは、profileIdで指定したプロファイルに保存された単語は有効にはなりません。profileWordsに設定した「AMI あみ」のみが有効になります。

grammarFileNames=-a-general profileId=:test profileWords="AMI あみ"

単語登録のテスト

音声ファイル(www.wav)をダウンロードしてコマンドを実行するディレクトリにコピーしてください。「とりぷるだぶる」という発話が録音されています。以下のパラメータを設定してサンプルを実行します。

{サービスID}は、マイページの接続情報に表示されている[サービス ID]です。先頭に「：」をつけてください。例えば、サービスIDがuser01の場合は、:user01のようにします。
{APP_KEY}は、マイページに表示されている[APPKEY]です。

curl https://acp-api.amivoice.com/v1/recognize \
     -F u={APP_KEY} \
     -F d="grammarFileNames=-a-general profileId=:{サービスID}" \
     -F a=@www.wav

JavaScript 版サンプルでは、単語登録の効果を、以下の手順で確認できます。

WrpTester.html または wrp.html をブラウザ（IE を除く）で開きます。
[プロファイル ID]に、マイページの[サービス ID]の先頭に":"を付加した文字列を入力します。
[APPKEY]に、マイページの[APPKEY]を入力します。
[録音開始]ボタンをクリックして、「とりぷるだぶる」と発話します。

JavaScript 版のサンプルでワンタイム APPKEY を取得して実行する手順はこちらを参照してください。

利用方法​

単語登録のテスト​

利用方法

単語登録のテスト