跳至主要内容

用户词典（单词注册・单词强调）

AmiVoice API 具有用户词典功能，当需要识别未被识别或难以识别的单词时， Hybrid 引擎可以进行"单词注册"，而 End to End 引擎可以进行"单词强调"。

这里首先介绍一个可以快速尝试用户词典功能的步骤。

快速入门​

备注

要运行 Python 示例代码，需要安装 requests 库。 将以下代码保存为 quickstart.py 等文件名，

python -m pip install requests

然后使用以下命令运行：

python quickstart.py

根据环境不同，可能需要使用 python3 或 py 替代 python。

1

注册用户词典

使用用户词典注册 API 或通过 MyPage 进行用户词典注册。这里我们将在"会話_汎用"引擎（-a-general）中注册"とりぷるだぶる"这个发音，使其被识别为"WWW"，如下所示：

  • 将 {API_key} 替换为您账户的 API key。
  • 将 {profile_id} 替换为您想使用的 profileId。例如，如果您想使用 test 作为 profile 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/ 下载适用于您操作系统的包，或使用包管理器安装 curl。
  • 语音识别结果格式使用 Unicode 转义。上述命令使用 jq 来美化响应。如果未安装 jq，请尝试删除 | jq 部分后执行。可以从 https://stedolan.github.io/jq/ 下载适用于您操作系统的 jq 包，或使用包管理器安装。
2

准备音频文件

准备要转写的音频文件。可以直接使用以下示例音频（www.wav）。

关于支持的音频文件格式，请参阅音频格式说明。

3

执行语音识别

请执行以下操作。将 {API_key} 替换为您账户的 API key，将 {profile_id} 替换为要使用的配置文件的 profileId，将 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/ 下载适用于您操作系统的包，或使用包管理器安装 curl。
  • 语音识别结果格式使用 Unicode 转义。上述命令使用 jq 来美化响应。如果未安装 jq，请尝试删除 | jq 部分后执行。可以从 https://stedolan.github.io/jq/ 下载适用于您操作系统的 jq 包，或使用包管理器安装。
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": ""
}

有关响应内容的详细信息，请参阅语音识别结果。

下一步​

对于 Hybrid 引擎，在默认状态下，语音识别引擎只能识别预先注册的单词。因此，如果想要识别引擎未知的专有名词等单词，就需要额外注册这些单词的信息。这个功能就是"单词注册"。

而对于 End to End 引擎，由于语音识别的机制与 Hybrid 引擎不同，它没有"预先注册的单词"这一概念。如果想要识别未被识别或难以识别的单词，需要通过提高该单词的出现频率来进行"单词强调"。

本节将按以下顺序进行解释：

有关 API 的参考，请参阅以下内容：

备注

某些语言不支持用户词典。有关详细信息，请参阅 AmiVoice API 支持的语言。

提示

AmiVoice Tech Blog 还介绍了用户词典的各种技巧。