1. 接口说明

通过该接口可对图片内物体类别进行识别。

2. 接口地址

  1. POST http://tupapi.xfyun.cn/v1/currency

3. 请求参数

在 Http Request Header 中配置授权认证参数,见【接口描述-授权认证】。其中 X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串,原始 JSON 串各字段说明如下:

参数类型必填说明备注
image_urlstring图片下载链接采用请求头设置image_url参数传入图片时填此参数
image_namestring图片名称image_url方式和Body传图片方式都需要设置图片名称,例如:img.jpg

注意:图片数据可以通过两种方式上传,第一种在请求头设置image_url参数,第二种将图片二进制数据写入请求体中。若同时设置,以第一种为准。

X-Param生成示例:

  1. 原始JSON串:
  2. {
  3. "image_name": "img.jpg"
  4. "image_url":""
  5. }
  6. BASE64编码(即X-Param):
  7. eyJlbmdpbmVfdHlwZSI6InNtczE2ayIsImF1ZSI6InJhdyJ9

在 Http Request Body 中配置以下参数:

将图片的二进制数据写入 Http Request Body 中

4. 返回值

返回值为 json 串,各字段如下:

JSON字段类型说明
codestring结果码(具体见错误码)
dataarray识别结果
descstring错误描述,会话成功为success
sidstring会话ID,用来唯一标识本次会话,如会话报错无法解决,可以通过工单提供 sid 给讯飞技术人员分析解决。

data字段说明:

JSON字段类型说明
labelnumber大于等于0时,表明图片属于哪个分类或结果;等于-1时,代表该图片文件有错误,或者格式不支持(gif图不支持)
labelsarray表示前5个最可能类别的label
ratestring介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高、机器越肯定
ratesarray和labels对应,前5个最可能类别对应得分
namestring图片的url地址或名称
reviewbool本次识别结果是否存在偏差,返回true时存在偏差,可信度较低,返回false时可信度较高,具体可参考rate参数值
tagstring图片标签,值为Local Image或Using Buffer(无实际意义)

label值范围较大,对应的物体类别达2万余个,文档不遍表述,详细对照表请点击下载

结果示例如下:

失败结果:

  1. {
  2. "code":"10106",
  3. "data":[],
  4. "desc":"invalid parameter|invalid X-Param",
  5. "sid":"tup00000001@ch239c0ef594db6a6b00"
  6. }

成功结果:

  1. {
  2. "code":"0",
  3. "data":[
  4. {
  5. "label":19015,
  6. "labels":[
  7. 19015,
  8. 18927,
  9. 18929,
  10. 698,
  11. 5588
  12. ],
  13. "name":"img.jpg",
  14. "rate":0.10702908039093018,
  15. "rates":[
  16. 0.10702908039093018,
  17. 0.08567219227552414,
  18. 0.0592394582927227,
  19. 0.04257886856794357,
  20. 0.04108942672610283
  21. ],
  22. "review":true,
  23. "tag":"Local Image"
  24. }
  25. ],
  26. "desc":"success",
  27. "sid":"tup00000005@ch2ee40efd592d6a6b00"
  28. }

5. 调用示例

物体识别demo go语言

物体识别demo php语言

物体识别demo java语言

物体识别demo python3语言

物体识别demo c#语言

Copyright © iflytek.com 2018 all right reserved,powered by Gitbook该文件修订时间:2019-05-07 07:12:51