调用CreateAsrVocab将一组语音热词上传到服务端，并获取返回的热词ID。服务地址(Region)请选择为杭州(cn-hangzhou)。
说明 热词用于解决某个特定名词（如人名、地名、专有名词等）识别不准的问题。
了解更多
了解更多
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateAsrVocab |
系统规定参数。取值：CreateAsrVocab。 |
| JsonStr | String | 是 | {"name":"热词名称"} |
完整Json字符串信息，具体内容参见以下详细信息。 |
|
属性 |
值类型 |
是否必须 |
说明 |
|---|---|---|---|
|
name |
String |
是 |
热词名称 |
|
words |
List |
是 |
热词列表 |
words说明
|
属性 |
值类型 |
是否必须 |
说明 |
|---|---|---|---|
|
word |
String |
是 |
热词 |
|
weight |
Integer |
否 |
权重，默认：2。取值范围为[-6, 5]之间的整数，不能超出限制。大于0的权重用来增加该词语被识别的概率，小于0的权重用来减小该词语被识别的概率。权重-6表示尽量不要识别出这个词语；权重2是常用的值，如果效果不明显可以适当增加权重，但是当权重较大时可能会有一些负面效果，导致其他词语识别不准确 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | 200 |
结果代码，200表示成功，若为别的值则表示失败，调用方可根据此字段判断失败原因。 |
| Data | String | 71b1795ac8634bd8bdf4d3878480c7c2 |
热词ID |
| Message | String | successful |
出错时表示出错详情，成功时为successful。 |
| RequestId | String | 96138D8D-8D26-4E41-BFF4-77AED1088BBD |
请求ID |
| Success | Boolean | true |
请求是否成功，调用方可根据此字段来判断请求是否成功：true表示成功；false/null表示失败。 |
示例
请求示例
http(s)://qualitycheck.cn-hangzhou.aliyuncs.com/?CreateAsrVocab
&JsonStr={"name":"热词名称"}
&<公共请求参数>正常返回示例
XML格式
<CreateAsrVocabResponse>
<code>200</code>
<data>71b1795ac8634bd8bdf4d3878480c7c2</data>
<message>successful</message>
<requestId>76DB5D8C-5BD9-42A7-B527-5AF3A5F83F12</requestId>
<success>true</success>
</CreateAsrVocabResponse>JSON格式
{
"code": "200",
"data": "71b1795ac8634bd8bdf4d3878480c7c2",
"message": "successful",
"requestId": "76DB5D8C-5BD9-42A7-B527-5AF3A5F83F12",
"success": true
}错误码
访问错误中心查看更多错误码。
调用示例
public void testCreateAsrVocab() throws ClientException {
CreateAsrVocabRequest request = new CreateAsrVocabRequest();
Map<String, Object> param = new HashMap<>(2);
List<Map<String, Object>> words = new ArrayList<>(2);
Map<String, Object> w1 = new HashMap<>(2);
w1.put("word", "萝卜");
w1.put("weight", 2);
words.add(w1);
w1 = new HashMap<>(2);
w1.put("word", "地瓜");
w1.put("weight", 2);
words.add(w1);
param.put("words", words);
param.put("name", "测试热词1");
request.setJsonStr(JSON.toJSONString(param));
CreateAsrVocabResponse response = client.getAcsResponse(request);
Assert.assertEquals(true, response.getSuccess());
vocabId = response.getData();
}
