1. 接口说明

通过该接口可对图片中人物表情进行识别。

2. 接口地址

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

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

label值范围及对应表情:

label值对应表情
0其他(非人脸表情图片)
1其他表情
2喜悦
3愤怒
4悲伤
5惊恐
6厌恶
7中性

结果示例如下:

失败结果:

  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":2,
  6. "name":"img.jpg",
  7. "rate":0.9147182106971741,
  8. "review":false,
  9. "tag":"Local Image"
  10. }
  11. ],
  12. "desc":"success",
  13. "sid":"tup00000001@ch13b40efd51096a6b00"
  14. }

5. 调用示例

人脸特征分析-表情demo go语言

人脸特征分析-表情demo java语言

人脸特征分析-表情demo php语言

人脸特征分析-表情demo python3语言

人脸特征分析-表情demo c#语言

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