开发者社区> 问答> 正文

词表管理API是什么?



关键词管理接口文档



1、 创建关键词词表



1.1 地址

协议URL方法
HTTPShttps://nlsapi.aliyun.com/asr/custom/keyword_listsPOST


1.2 请求



body实例

  1. {
  2.     "keywords": [
  3.         {"keyword":"张三", "threshold":0.1},
  4.         {"keyword":"李四", "threshold":0.0}
  5.     ]
  6. }
参数值类型必须项描述
keywordStringyes关键词
thresholdfloatno阈值,取值范围0~1,默认为0

注意:阈值设置越高,关键词准确率越高,但同时遗漏识别的概率增大。需要用户根据自身具体场景尝试不同取值的效果,不存在各场景通用的推荐值。

1.3 响应

  • HTTP状态说明见页末附表


body实例

  1. {
  2.     "keyword_list_id": "be053bf9af0e406dafa8249631372d53",
  3.     "request_id": "be053bf9af0e406dafa8249631372d53"
  4. }


JSON对象

属性值类型描述
keyword_list_idString本次创建的关键词词表的id
request_idString本次调用id


1.4 示例-请求

  1. curl -X POST --data "{\"keywords\": [{\"keyword\":\"张三\", \"threshold\":0.8},{\"keyword\":\"李四\", \"threshold\":0.7}]}" "https://localhost/asr/custom/keyword_lists"


正常示例-响应

  1. {
  2.     "keyword_list_id": "be053bf9af0e406dafa8249631372d53",
  3.     "request_id": "be053bf9af0e406dafa8249631372d53"
  4. }




2、 更新关键词词表



2.1 地址

协议URL方法
HTTPShttps://nlsapi.aliyun.com/asr/custom/keyword_lists/{keyword_list_id}PUT


2.2 请求



body实例:

  1. {
  2.     "keywords": [
  3.         {"keyword":"张三", "threshold":0.8},
  4.         {"keyword":"李四", "threshold":0.7}
  5.     ]
  6. }
参数值类型必须项描述
keywordStringyes关键词
thresholdfloatyes阈值


2.3 响应

  • HTTP状态说明见页末附表


body实例

  1. {
  2.     "keyword_list_id": "be053bf9af0e406dafa8249631372d53",
  3.     "request_id": "be053bf9af0e406dafa8249631372d53"
  4. }


JSON对象

属性值类型描述
keyword_list_idString本次创建的关键词词表的id
request_idString本次调用id


2.4 示例-请求

  1. curl -X PUT --data "{\"keywords\": [{\"keyword\":\"张三\", \"threshold\":0.8},{\"keyword\":\"李四\", \"threshold\":0.7}]}" "https://localhost/asr/custom/keyword_lists/be053bf9af0e406dafa8249631372d53"


正常示例-响应

  1. {
  2.     "keyword_list_id": "be053bf9af0e406dafa8249631372d53",
  3.     "request_id": "be053bf9af0e406dafa8249631372d53"
  4. }


3、 获取关键词词表



3.1 地址

协议URL方法
HTTPShttps://nlsapi.aliyun.com/asr/custom/keyword_lists/{keyword_list_id}GET


3.2 请求



body:无



3.3 响应

  • HTTP状态说明见页末附表


body实例:

  1. {
  2.     "request_id": "be053bf9af0e406dafa8249631372d53",
  3.     "keywords": [
  4.         {"keyword":"张三", "threshold":0.8},
  5.         {"keyword":"李四", "threshold":0.7}
  6.     ]
  7. }


JSON对象

参数值类型描述
request_idString本地调用id
keywordString关键词
thresholdfloat阈值


3.4 示例-请求

  1. curl -X GET "https://localhost/asr/custom/keyword_lists/be053bf9af0e406dafa8249631372d53"


正常示例-响应

  1. {
  2.     "keywords": [
  3.         {"keyword":"张三", "threshold":0.8},
  4.         {"keyword":"李四", "threshold":0.7}
  5.     ],
  6.     "request_id": "be053bf9af0e406dafa8249631372d53"
  7. }




4、 删除关键词词表



4.1 地址

协议URL方法
HTTPShttps://nlsapi.aliyun.com/asr/custom/keyword_lists/{keyword_list_id}DELETE


4.2 请求



body:无



4.3 响应

  • HTTP状态说明见页末附表


body实例:

  1. {
  2.     "request_id": "be053bf9af0e406dafa8249631372d53"
  3. }


JSON对象

参数值类型描述
request_idString本地调用id


4.4 示例-请求

  1. curl -X GET "https://localhost/asr/custom/keyword_lists/be053bf9af0e406dafa8249631372d53"


正常示例-响应

  1. {
  2.     "request_id": "be053bf9af0e406dafa8249631372d53"
  3. }


HTTP状态说明

错误码含义
200成功
400词表id或词表内容格式错误
404词表不存在
409(新增时)词表已存在

展开
收起
nicenelly 2017-11-01 10:25:04 2209 0
0 条回答
写回答
取消 提交回答
问答分类:
问答标签:
问答地址:
问答排行榜
最热
最新

相关电子书

更多
CUDA MATH API 立即下载
API PLAYBOOK 立即下载
传统企业的“+互联网”-API服务在京东方的实践 立即下载