跳至主要内容

请求参数

本文介绍在使用 AmiVoice API 发送语音识别请求时可以设置的参数。虽然 HTTP 和 WebSocket 接口的发送方式不同，但可以设置的参数是相同的。

参数列表​

authorization(认证信息)和grammarFileNames(连接引擎名称)是必需的。其他参数是可选的。某些参数可能不适用于所有接口，请参考下表。

参数名称说明
必需
同步HTTP
WebSocket
异步HTTP
authorization认证信息●●●●
grammarFileNames连接引擎名称●●●●
profileIdprofile ID●●●
profileWords单词注册列表●●●
keepFillerToken控制自动删除填充词(无意义词语)●●●
segmenterProperties语音段检测和说话人区分的参数●●● （*1）
extension使用量统计标签●●●
resultUpdatedInterval识别中事件的间隔●
loggingOptOut更改日志保存的有无●
contentId用户定义 ID●
compatibleWithSync结果格式的兼容性●
speakerDiarization说话人区分启用选项●
diarizationMinSpeaker说话人区分的最小预估说话人数●
diarizationMaxSpeaker说话人区分的最大预估说话人数●
sentimentAnalysis情绪分析启用选项●

（*1）在异步 HTTP 接口中，无法使用与说话人区分相关的参数

有关这些请求参数的发送方法，请参阅以下部分：

参数详情​

以下是各参数的详细说明。

必需参数​

authorization​

认证信息

使用 API 时必须设置认证信息。认证信息是在 MyPage 上显示的 [APPKEY]，或者通过一次性 APPKEY 发行 API获取的一次性 APPKEY。

警告

从浏览器应用程序连接到语音识别服务器时，为避免将 APPKEY 写入 HTML 文件，请使用一次性 APPKEY。详情请参阅一次性 APPKEY。

grammarFileNames​

连接引擎名称

指定该会话中要使用的语音识别引擎。每个会话指定一个。可设置的值请参考连接引擎名称列表或 MyPage。详情请参阅语音识别引擎。

可选参数​

profileId​

profile ID

profile 是存在于语音识别服务器上的每个用户的数据文件，用户可以为其命名并保存注册的单词。profile ID 是用于指定该数据文件的标识符。详情请参阅单词注册。

profileWords​

单词注册列表

可以注册在会话中有效的单词。每个单词以"显示(半角空格)读音"的格式注册。如果要指定类名，请使用"显示<半角空格>读音 <半角空格> 类名"的格式。注册多个单词时，用"|"(半角竖线)分隔单词。值的格式如下(以下是未指定类名的示例)：

显示1 读音1|显示2 读音2|显示3 读音3|显示4 读音4

详情请参阅单词注册。

keepFillerToken​

控制自动删除填充词(无意义词语)

指定1或0。默认值为0。当不想自动删除语音识别结果中包含的填充词(如"あー"或"えー"等)时，指定1。另请参阅填充词自动删除。

填充词前后用半角"%"包围。以下是填充词的示例：

%あー%
%えー%
%おー%
%えっと%
提示

另请参阅 AmiVoice Tech Blog 上的如何在 AmiVoice API 中选择显示或删除无意义词语(填充词)。

segmenterProperties​

语音段检测参数

这些参数用于调节语音的检测灵敏度等。建议先使用默认设置进行尝试，然后根据需要进行调整。 可以设置以下参数：

警告

默认值可能会在没有预先通知的情况下发生变更。

  • threshold
    • 用于判断是否为语音的得分阈值，得分大于或等于此值时被视为语音。降低此值会使语音更容易被检测到，减少语音中断或末尾被截断的情况，但也会增加误检测的可能性。在有较多噪音的环境中，如果误检测明显，可以增大此值。
    • 默认值为 5000。
  • preTime
    • 当被视为语音的时间持续一定时间后，系统会进入语音段检测状态，此值用于指定这个"一定时间"的长度。如果短语音无法被检测到或语音开头容易被截断，可以减小此值。如果短噪音的误检测较多，可以增大此值。
    • 单位为毫秒，默认值为 100。请以 50 的倍数指定。
  • postTime
    • 当语音段末尾被视为非语音的时间持续一定时间后，系统会结束语音段检测状态，此值用于指定这个"一定时间"的长度。如果语音中途被分割，可以增大此值。如果两个语音段连在一起，可以减小此值。
    • 单位为毫秒，默认值为 550。
  • preForcedTime
    • 当进入语音段检测状态时，此值用于指定从被视为语音的最初时刻向前回溯多长时间作为语音段的开始点。如果语音开头容易被截断，可以增大此值。
    • 单位为毫秒，默认值为 350。
  • postForcedTime
    • 当语音段检测状态结束时，此值用于指定从被视为非语音的最后时刻向后延伸多长时间作为语音段的结束点。如果语音末尾容易被截断，可以增大此值。如果实时响应性变差，可以减小此值。
    • 单位为毫秒，默认值为 350。
  • powerThreshold
    • 在判断是否为语音时，如果还要考虑音量（功率），此值用于指定得分的阈值。需要与threshold分开设置，设为 0 或更小的值则无效。如果得分低于阈值，则被视为非语音。如果背景中的小声音容易被检测到，可以增大此值。
    • 默认值为 100。
  • decayTime
    • 可以在经过一定时间后单调减小postTime的值，使语音更容易被切断，此值用于指定这个"一定时间"。如果检测到的语音段过长，可以减小此值。
    • 单位为毫秒，默认值为 5000。

与说话人区分相关的参数

这些是与说话人区分相关的参数。仅在同步 HTTP 和 WebSocket 接口中可设置。可以设置以下参数：

  • useDiarizer
    • 设置为1时，在同步 HTTP 或 WebSocket 接口中启用说话人区分。默认为禁用。详情请参阅说话人区分。
  • diarizerAlpha
    • 控制同步 HTTP 或 WebSocket 接口中说话人区分新说话人出现的容易程度的参数。指定较大的值会使新说话人更容易出现，指定较小的值会使新说话人更难出现。diarizerAlpha=0是特殊情况，会被视为指定了 1e0，即 1。如果未设置，则默认为diarizerAlpha=0。
  • diarizerTransitionBias
    • 控制同步 HTTP 或 WebSocket 接口中说话人区分说话人切换容易程度的参数。指定较大的值会使说话人更容易切换，指定较小的值会使说话人更难切换。diarizerTransitionBias=0是特殊情况，会被视为指定了 1e-40。但是，对于支持 8KHz 音频的引擎，例如使用通用引擎(-a-general)并发送采样率为 8kHz 的音频时，会被视为指定了 1e-20。如果未设置，则默认为diarizerTransitionBias=0。
参数设置方法​

在segmenterProperties=后面添加参数设置。同时设置多个参数时，各参数之间用半角空格分隔。

使用 curl 命令的同步 HTTP 接口设置示例​

设置多个参数时，插入的半角空格需要 URL 编码为%20。

curl https://acp-api.amivoice.com/v1/recognize \
     -F u={APP_KEY} \
     -F d="grammarFileNames=-a-general segmenterProperties=threshold=4000%20postTime=600" \
     -F a=@test.wav
WebSocket 接口设置示例​

将设置给segmenterProperties的整个参数用双引号"..."括起来。

s 16K -a-general authorization={APPKEY} segmenterProperties="preTime=200 useDiarizer=1 diarizerAlpha=1e-20"

extension​

使用量统计标签

当多个系统、环境或最终用户共用同一个 AmiVoice API 账户时，可以设置统计标签以获取按任意属性分类的使用量。详情请参阅使用量统计标签。

WebSocket API 特有参数​

resultUpdatedInterval​

识别中事件的间隔

以毫秒为单位指定发送识别中事件的间隔。

  • 设置为 0 时不发送识别中事件。
  • 每经过指定的时间就发送一次识别中事件。如果在指定的时间内语音识别的中间结果没有更新，则会发送在前一个中间识别结果末尾添加一个"."的结果。如果指定的值包含小于 100 的小数部分，则会向上取整到 100 的倍数。

异步 HTTP 接口特有参数​

loggingOptOut​

更改日志保存的有无

loggingOptOut=<True|False> 指定是否保存日志。设置为 True 时，系统在会话期间不会保存日志。默认为 False。

contentId​

用户定义 ID

contentId=<任意字符串> 可以指定用户自定义的任意字符串。该字符串将包含在会话期间的状态和结果响应中。默认为 None。

compatibleWithSync​

结果格式的兼容性

compatibleWithSync=<True|False> 以与同步 HTTP 接口兼容的格式输出结果。默认为 False。

speakerDiarization​

说话人区分启用选项

speakerDiarization=<True|False> 启用说话人区分。默认为 False。详情请参阅说话人区分。

diarizationMinSpeaker​

说话人区分的最小预估说话人数

diarizationMinSpeaker=<int> 仅在启用说话人区分时有效，可以指定音频中包含的最小说话人数。需要设置为 1 或更大。默认为 1。详情请参阅说话人区分。

diarizationMaxSpeaker​

说话人区分的最大预估说话人数

diarizationMaxSpeaker=<int> 仅在启用说话人区分时有效，可以指定音频中包含的最大说话人数。需要设置为不小于 diarizationMinSpeaker 的值。默认为 10。详情请参阅说话人区分。

sentimentAnalysis​

情绪分析启用选项

sentimentAnalysis=<True|False> 启用情绪分析。默认为 False。

详情请参阅情绪分析。