热词管理接口-华为云

语音交互服务 SIS-创建热词表:约束与限制

约束与限制所有含英文的热词均需大写，如：Eiffel铁塔（正确示例为：EIFFEL铁塔）。所有数字均用相应的汉字表示，避免使用阿拉伯数字，如：12345服务热线（正确示例为：一二三四五服务热线）。热词内容仅包含英文和中文，避免出现标点符号、特殊字符或空格，如：。，？.*等。尽量避免配置单音节的英文单词，避免误召回，如：MAY/TEE等。使用热词表功能时，同一个项目ID，可以共用热词表，不同的项目ID不能共用热词表。

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-创建热词表:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见认证鉴权。响应消息头中X-Subject-Token的值即为Token。表3 请求Body参数参数是否必选参数类型描述 name 是 String 热词表名，不可重复。内容限制为字母，数字，下中划线和井号，长度不超过32字符。 description 否 String 热词表描述，长度不超过255字符。 language 是 String 热词表语言类型。 language取值：chinese_mandarin，表示汉语普通话。 contents 是 Array of String 支持中英混编热词，单个热词只能由英文字母和unicode编码的汉字组成，不能有其他符号，包括空格。阿拉伯数字需写成汉字或英文（如“一”、“one”）。单词库支持热词数上限10000。中文单个热词长度上限32字符，英文为64字符。

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-创建热词表:请求示例

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。创建热词表 POST https://{endpoint}/v1/{project_id}/asr/vocabularies Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "name": "telepower", "description": "telepower 具体描述", "language": "chinese_mandarin", "contents": ["示例"] } 调用热词时，需确保调用热词的区域与创建热词区域一致。如下图位置，可查看创建的热词表所在区域：图2 查看创建的热词表位置

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-更新热词表:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见认证鉴权。响应消息头中X-Subject-Token的值即为Token。表3 请求Body参数参数是否必选参数类型描述 name 是 String 热词表名，不可重复。内容限制为字母，数字，下中划线和井号，长度不超过32字节。 description 否 String 热词表描述，长度不超过255字节。 language 是 String 热词表语言类型。 language取值：chinese_mandarin，表示汉语普通话。 contents 是 Array of strings 支持中英混编热词，单个热词只能由英文字母和unicode编码的汉字组成，不能有其他符号，包括空格。单词库支持热词数上限10000。单个热词长度上限32字节。

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-更新热词表:请求示例

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。更新热词表 PUT https://{endpoint}/v1/{project_id}/asr/vocabularies/{vocabulary_id} Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "name": "telepower", "description": "telepower 具体描述", "language": "chinese_mandarin", "contents": ["示例"] }

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-查询热词表列表:请求示例

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。获取热词表列表信息 GET https://{endpoint}/v1/{project_id}/asr/vocabulariesRequest Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-查询热词表列表:响应示例

响应示例状态码：200 成功响应示例 { "result": [ { "vocabulary_id": "5F85A74C-BED9-4a15-B66E-039251D877D6", "language": "chinese_mandarin", "name": "weather", "description": "no desc" }, { "vocabulary_id": "50875954-7328-42ab-B236-B3EC6E22207A", "language": "chinese_mandarin", "name": "war", "description": "no desc" } ]} 状态码：400 失败响应示例 { "error_code":"SIS.0201", "error_msg":"***" }

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-查询热词表列表:响应参数

响应参数状态码： 200 表5 响应Body参数参数是否必选参数类型描述 count 是 Integer 热词表数。 result 是 Array of VocabInfo objects 调用成功返回热词表列表，调用失败时无此字段。表6 VocabInfo 参数是否必选参数类型描述 vocabulary_id 是 String 热词ID。 name 是 String 热词表名。 language 是 String 热词表语言类型。 description 是 String 热词表描述。状态码： 400 表7 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

语音交互服务 SIS 热词管理接口

语音交互服务 SIS-查询热词表列表:URI

URI GET /v1/{project_id}/asr/vocabularies 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。表2 Query参数参数是否必选参数类型描述 limit 否 Integer 每页查询显示的条目数量。缺省值：10 offset 否 Integer 页码偏移量，表示从此页码偏移量开始查询，offset大于等于0。缺省值：0

语音交互服务 SIS 热词管理接口

云服务器内容精选

热词管理接口

7*24

备案

专业服务

退订

建议反馈

售前咨询热线