创建热词表

最近更新时间:2020-01-15 19:33:57

1. 接口描述

接口请求域名: asr.tencentcloudapi.com 。

用户通过本接口进行热词表的创建。
• 默认最多可创建30个热词表。
• 每个热词表最多可添加128个词,每个词最长10个字,不能超出限制。
• 热词表可以通过数组或者本地文件形式上传。
• 本地文件必须为UTF-8编码格式,每行仅添加一个热词且不能包含标点和特殊字符。
• 热词权重取值范围为[1,10]之间的整数,权重越大代表该词被识别出来的概率越大。

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateAsrVocab。
Version String 公共参数,本接口取值:2019-06-14。
Region String 公共参数,本接口不需要传递此参数。
Name String 热词表名称,长度在1-255之间
Description String 热词表描述,长度在0-1000之间
WordWeights.N Array of HotWord 词权重数组,包含全部的热词和对应的权重。每个热词的长度不大于10,权重为[1,10]之间整数,数组长度不大于128
WordWeightStr String 词权重文件(纯文本文件)的二进制base64编码,以行分隔,每行的格式为word|weight,即以英文符号|为分割,左边为词,右边为权重,如:你好|5。
当用户传此参数(参数长度大于0),即以此参数解析词权重,WordWeights会被忽略

3. 输出参数

参数名称 类型 描述
VocabId String 词表ID,可用于获取词表信息
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建热词表

用户通过上传词权重数组方式创建热词表

输入示例

https://asr.tencentcloudapi.com/?Action=CreateAsrVocab
&Name=词表名称
&Description=词表描述
&WordWeights.0.Word=智聆
&WordWeights.0.Weight=1
&WordWeights.1.Word=滨海大厦
&WordWeights.1.Weight=6
&WordWeights.2.Word=存储桶
&WordWeights.2.Weight=8
&WordWeights.3.Word=核保
&WordWeights.3.Weight=10
&<公共请求参数>

输出示例

{
  "Response": {
    "VocabId": "aa6f402f263f12ea856fc81fbecfd0sd",
    "RequestId": "b3808ad3-d8dd-4b65-96c9-7d6f1f81b6b6"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation 操作失败。
FailedOperation.ServiceIsolate 账号因为欠费停止服务,请在腾讯云账户充值。
InternalError 内部错误。
InternalError.FailAccessDatabase 访问数据库失败。
InvalidParameter 参数错误。
InvalidParameter.ErrorContentlength 请求数据长度无效。
InvalidParameter.ErrorParamsMissing 参数不全。
InvalidParameter.ErrorParsequest 解析请求数据失败。
InvalidParameter.InvalidVocabState 非法的词表状态。
InvalidParameterValue 参数取值错误。
InvalidParameterValue.ErrorInvalidAppid AppId无效。
InvalidParameterValue.ErrorInvalidClientip ClientIp无效。
InvalidParameterValue.InvalidParameterLength 非法的参数长度。
InvalidParameterValue.InvalidVocabId 非法的VocabId。
InvalidParameterValue.InvalidWordWeight 词权重不合法。
InvalidParameterValue.InvalidWordWeightStr 非法的WordWeightStr。
LimitExceeded 超过配额限制。
LimitExceeded.VocabFull 热词表数量已到账号限制。
MissingParameter 缺少参数错误。
UnknownParameter 未知参数错误。