调用CreateAsrVocab将一组语音热词上传到服务端,并获取返回的热词ID。服务地址(Region)请选择为杭州(cn-hangzhou)。

说明 热词用于解决某个特定名词(如人名、地名、专有名词等)识别不准的问题。了解更多

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateAsrVocab

系统规定参数。取值:CreateAsrVocab。

JsonStr String {"name":"热词名称"}

完整Json字符串信息,具体内容参见以下详细信息。

请求参数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();
    }