プロファイルと単語登録

プロファイルとは、音声認識サーバ上に保管されるユーザーごとのデータファイルです。プロファイルに保存される主なデータは、そのユーザーが登録した単語です。音声認識 API の接続時にプロファイル ID を指定すれば、その接続中における音声認識処理で、プロファイルに保存された単語が利用されます。

マイページの単語登録からプロファイルに単語登録

AmiVoice API の登録ユーザーには、そのユーザー ID を識別子とするプロファイル（マイ単語帳）が、自動的に割り当てられます。AmiVoice API のマイページにログインし、単語登録を行うと、その単語は「マイ単語帳」に登録されます。「マイ単語帳」を認識処理に利用するには、音声認識 API の接続時に「ユーザー ID の先頭に半角コロン”:”を付加した文字列」を profileId に指定します。例えばユーザー ID が「aiueo12345」だとすると、「:aiueo12345」を profileId に指定します。

マイページの単語登録画面は以下です。表示するにはログインが必要です。

例えば、「とりぷるだぶる」という発話を"WWW"に変換するためには以下のようにします。

1. AmiVoice API にログインし、マイページの[単語登録] をクリックします。

2. [接続エンジン名] より、単語を登録したいエンジン名を選択します。ここでは、[-a-general]を選択します。

3. [表記]に「WWW」、[読み]に「とりぷるだぶる」を入力します。

   • 登録したい単語に適したクラスが無い場合は、[クラス]は未選択のままにしてください。ここでは何も選択しません。
   • クラスの「名前」は人名の苗字を、「名前(名)」は人名のファーストネームを表しています。

4. 登録ボタンをクリックします。

5. 次に、 以下のコマンドを使用して音声認識を行なってください。認識結果には、"WWW"という表記が含まれているはずです。

note

• 引数の<:ユーザー ID>は、マイページに表示されている[ユーザー ID]の先頭に":"を付加した文字列です。
• 引数の<AppKey>は、マイページに表示されている[APPKEY]です。
• 引数の www.wav には「とりぷるだぶる」という発話が録音されています。

HTTP 音声認識 API で確認

Java

java -cp .;Hrp.jar HrpTester https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>

C#

bin\Release\HrpTester.exe https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16k g=-a-general i=<:ユーザーID> u=<AppKey>

PHP

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>

Python

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

curl -X POST -F a=@../../audio/www.wav "https://acp-api.amivoice.com/v1/recognize?d=-a-general profileId=<:ユーザーID>&u=<AppKey>

info

'd'パラメータに与える"-a-general profileId=<:ユーザー ID>"の部分は URL エンコードしてください。

例）

エンコード前：-a-general profileId=:test

エンコード後：-a-general%20profileId%3D%3Atest

WebSocket 音声認識 API で確認

Java

java -cp .;Wrp.jar WrpTester wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>

C#

bin\Release\WrpTester.exe wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16k g=-a-general i=<:ユーザーID> u=<AppKey>

PHP

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>

Python

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 版サンプルでは、単語登録の効果を、以下の手順で確認できます。

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

JavaScript 版のサンプルでワンタイム AppKey を取得して実行する手順はこちら。