CreateAsrVocab - 新建热词组

将一组语音热词上传到服务端,并获取返回的热词ID。

接口说明

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
JsonStrstring

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

{"name":"热词名称"}
BaseMeAgentIdlong

业务空间 Id

请求参数 Json 字符串信息

属性值类型是否必须说明
nameString热词名称
wordsList热词列表

words 说明

属性值类型是否必须说明
wordString热词
weightInteger权重,默认:2。取值范围为【-6,5】之间的整数,不能超出限制。大于 0 的权重用来增加该词语被识别的概率,小于 0 的权重用来减小该词语被识别的概率。权重-6 表示尽量不要识别出这个词语;权重 2 是常用的值,如果效果不明显可以适当增加权重,但是当权重较大时可能会有一些负面效果,导致其他词语识别不准确

返回参数

名称类型描述示例值
object
Codestring

结果代码,200 表示成功,若为别的值则表示失败,调用方可根据此字段判断失败原因。

200
Messagestring

出错时表示出错详情,成功时为 successful

successful
Datastring

热词 ID

71b1795ac8634bd8bdf4d3878480c7c2
RequestIdstring

请求 ID

96138D8D-8D26-4E41-BFF4-77AED1088BBD
Successboolean

请求是否成功,调用方可根据此字段来判断请求是否成功:true 表示成功;false/null表示失败。

true

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "successful",
  "Data": "71b1795ac8634bd8bdf4d3878480c7c2",
  "RequestId": "96138D8D-8D26-4E41-BFF4-77AED1088BBD",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-01API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用

调用示例

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();
    }