プロファイルと単語登録
プロファイルとは、音声認識サーバ上に保管されるユーザーごとのデータファイルです。プロファイルに保存される主なデータは、そのユーザーが登録した単語です。音声認識 API の接続時にプロファイル ID を指定すれば、その接続中における音声認識処理で、プロファイルに保存された単語が利用されます。
マイページの単語登録からプロファイルに単語登録
AmiVoice API の登録ユーザーには、そのユーザー ID を識別子とするプロファイル(マイ単語帳)が、自動的に割り当てられます。AmiVoice API のマイページにログインし、単語登録を行うと、その単語は「マイ単語帳」に登録されます。「マイ単語帳」を認識処理に利用するには、音声認識 API の接続時に「ユーザー ID の先頭に半角コロン”:”を付加した文字列」を profileId に指定します。例えばユーザー ID が「aiueo12345」だとすると、「:aiueo12345」を profileId に指定します。
マイページの単語登録画面は以下です。表示するにはログインが必要です。
例えば、「とりぷるだぶる」という発話を"WWW"に変換するためには以下のようにします。
AmiVoice API にログインし、マイページの[単語登録] をクリックします。
[接続エンジン名] より、単語を登録したいエンジン名を選択します。ここでは、[-a-general]を選択します。
[表記]に「WWW」、[読み]に「とりぷるだぶる」を入力します。
- 登録したい単語に適したクラスが無い場合は、[クラス]は未選択のままにしてください。ここでは何も選択しません。
- クラスの「名前」は人名の苗字を、「名前(名)」は人名のファーストネームを表しています。
登録ボタンをクリックします。
次に、 以下のコマンドを使用して音声認識を行なってください。認識結果には、"WWW"という表記が含まれているはずです。
- 引数の<:ユーザー ID>は、マイページに表示されている[ユーザー ID]の先頭に":"を付加した文字列です。
- 引数の<AppKey>は、マイページに表示されている[APPKEY]です。
- 引数の www.wav には「とりぷるだぶる」という発話が録音されています。
HTTP 音声認識 API で確認
- Java
- C#
- PHP
- Python
- curl
java -cp .;Hrp.jar HrpTester https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
bin\Release\HrpTester.exe https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16k g=-a-general i=<:ユーザーID> u=<AppKey>
php -dinclude_path=src -dopenssl.cafile= ../../curl-ca-bundle.crt -dextension=openssl HrpTester.php https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
set PYTHONPATH=src
set SSL_CERT_FILE=../../curl-ca-bundle.crt
python HrpTester.py https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
curl -X POST -F a=@../../audio/www.wav "https://acp-api.amivoice.com/v1/recognize?d=-a-general profileId=<:ユーザーID>&u=<AppKey>
'd'パラメータに与える"-a-general profileId=<:ユーザー ID>"の部分は URL エンコードしてください。
例)
エンコード前:-a-general profileId=:test
エンコード後:-a-general%20profileId%3D%3Atest
WebSocket 音声認識 API で確認
- Java
- C#
- PHP
- Python
java -cp .;Wrp.jar WrpTester wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
bin\Release\WrpTester.exe wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16k g=-a-general i=<:ユーザーID> u=<AppKey>
php -dinclude_path=src -dopenssl.cafile=curl-ca-bundle.crt -dextension=../../openssl WrpTester.php wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
set PYTHONPATH=src
set SSL_CERT_FILE=../../curl-ca-bundle.crt
python WrpTester.py wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
JavaScript
JavaScript 版サンプルでは、単語登録の効果を、以下の手順で確認できます。
- WrpTester.html または wrp.html をブラウザ(IE を除く)で開きます。
- [プロファイル ID]に、マイページの[ユーザー ID]の先頭に":"を付加した文字列を入力します。
- [AppKey]に、マイページの[APPKEY]を入力します。
- [録音開始]ボタンをクリックして、「とりぷるだぶる」と発話します。
JavaScript 版のサンプルでワンタイム AppKey を取得して実行する手順はこちら。