メインコンテンツまでスキップ

ユーザー辞書（単語登録・単語強調）

AmiVoice API にはユーザー辞書機能があり、認識しない単語や認識しにくい単語を認識させたい場合、ハイブリッドエンジンでは「単語登録」が、End to End エンジンでは「単語強調」が行えます。

ここではまず、ユーザー辞書機能を簡単に試せる手順を紹介します。

クイックスタート​

注記

Python のサンプルコードを実行するには、requestsライブラリが必要です。 以下のコードを quickstart.py などのファイル名で保存し、

python -m pip install requests

以下のコマンドで実行してください。

python quickstart.py

環境によっては、python の代わりに python3 または py を使用してください。

1

ユーザー辞書登録をする

ユーザー辞書登録 API を利用するか、マイページからユーザー辞書登録を行います。ここでは、「会話_汎用」エンジン（-a-general）で「とりぷるだぶる」という発話を「WWW」と認識するように、以下のように登録します。

  • {API_key}には自身のアカウントの API キーを指定します。
  • {profile_id}には任意のプロファイル ID を指定します。たとえばtestというプロファイル ID を使用したい場合は、以下の{profile_id}の部分にtestと記述します。
curl https://acp-api.amivoice.com/profilewords/-a-general/{profile_id} \
     -H "Authorization: Bearer {API_key}" \
     -H "Content-Type: application/json" \
     -d '{"profilewords":[{"written":"WWW","spoken":"とりぷるだぶる"}]}' | jq
注記
  • curlコマンドがインストールされていない場合、https://curl.se/ からご利用の OS のパッケージをダウンロードするか、パッケージマネージャを利用してcurlをインストールしてください。
  • 結果テキストはUnicodeエスケープされています。上記コマンドでは、レスポンスを見やすく整形するためにjqを使用しています。jqがインストールされていない場合は、| jqの部分を除いて実行してみてください。jqコマンドは、https://stedolan.github.io/jq/ からご利用の OS のパッケージをダウンロードするか、パッケージマネージャを利用してインストールできます。
2

音声ファイルを用意する

書き起こしたい音声ファイルを用意します。以下のサンプル音声（www.wav）をそのまま使えます。

対応している音声ファイルの形式については音声フォーマットについてを参照してください。

3

音声認識を実行する

以下を実行してください。{API_key}は自身のアカウントの API キーに、{profile_id}は使用するプロファイルのプロファイル ID に、www.wav は使用する音声ファイルのパスに置き換えてください。

curl https://acp-api.amivoice.com/v1/recognize \
     -F u={API_key} \
     -F d="grammarFileNames=-a-general profileId=:{profile_id}" \
     -F a=@www.wav | jq
注記
  • curlコマンドがインストールされていない場合、https://curl.se/ からご利用の OS のパッケージをダウンロードするか、パッケージマネージャを利用してcurlをインストールしてください。
  • 結果テキストはUnicodeエスケープされています。上記コマンドでは、レスポンスを見やすく整形するためにjqを使用しています。jqがインストールされていない場合は、| jqの部分を除いて実行してみてください。jqコマンドは、https://stedolan.github.io/jq/ からご利用の OS のパッケージをダウンロードするか、パッケージマネージャを利用してインストールできます。
4

結果を確認する

成功すると以下のような JSON が返ります。text フィールドに書き起こし結果が含まれます。

{
  "results": [
    {
      "tokens": [ ... ],
      "confidence": 0.94,
      "starttime": 500,
      "endtime": 2084,
      "tags": [],
      "rulename": "",
      "text": "WWW"
    }
  ],
  "utteranceid": "20260611/18/019eb5f848ac0a3013ba94cb_20260611_181648",
  "text": "WWW",
  "code": "",
  "message": ""
}

詳細なレスポンスの内容については音声認識の結果を参照してください。

次のステップ​

ハイブリッドエンジンの場合、デフォルトの状態では、音声認識エンジンは予め登録されている単語しか認識することができません。このため固有名詞などでエンジンが知らない単語を認識させたい場合、その単語の情報を追加で登録する必要があります。このための機能が「単語登録」です。

一方、End to End エンジンの場合、ハイブリッドエンジンとは音声認識の仕組みが異なり、「予め登録されている単語」というものを持っていません。認識しない・認識しにくい単語を認識させたい場合は、その単語の出現頻度を高める「単語強調」を行います。

このセクションでは以下を順に説明します。

APIのリファレンスは以下を参照してください。

注記

言語によってはユーザー辞書に対応していません。詳細はAmiVoice APIが対応している言語を参照してください。

ヒント

AmiVoice Tech Blogでもユーザー辞書の様々なTIPSを紹介しています。