全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

人脸属性识别API调用说明

更新时间:2017-07-12 19:35:58

URL说明

协议 URL 方法 参数
HTTPS <host>/face/attribute POST JSON字符串

<host> 参见Api调试页面的:请求地址

输入参数

请求参数,以json格式放置于Https Body内

参数 类型 必选 说明 举例
type int 0: 通过url识别,参数image_url不为空;1: 通过图片content识别,参数content不为空 0
image_url string 输入图像URL http://a.com/a.jpg
content String 图像内容,base64编码  

返回结果

参数 类型 说明 举例
errno int 0为成功,非0为失败,详细说明参加错误码 0
err_msg string 处理失败时的说明 invalid image url.
request_id string request_id 请求id信息 xx-xx
face_num int 检测出来的人脸个数 2
face_rect int数组 返回人脸矩形框,分别是[left, top, width, height], 如有多个人脸,则依次顺延,返回矩形框。如有两个人脸则返回[left1, top1, width1, height1, left2, top2, width2, height2] [118,166,340,445]
face_prob float数组 返回人脸概率, 0-1之间,如有多个人脸,则依次顺延。如有两个人脸则返回[face_prob1, face_prob2] [0.93]
pose float数组 返回人脸姿态[yaw, pitch, roll], yaw为左右角度,取值[-90, 90],pitch为上下角度,取值[-90, 90], roll为平面旋转角度,取值[-180, 180],如有多个人脸,则依次顺延 [10.0, 20.5, -10.0]
landmark_num int 特征点数目,目前固定为105点(顺序:眉毛24点,眼睛32点,鼻子6点,嘴巴34点,外轮廓9点) 105
landmark float数组 特征点定位结果,每个人脸返回一组特征点位置,表示方式为(x0, y0, x1, y1, ……);如有多个人脸,则依次顺延,返回定位浮点数 [195.963501, 371.919922, …..]
iris float数组 左右两个瞳孔的中心点坐标和半径,每个人脸6个浮点数,顺序是[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis] [200.000, 150.000, …]
gender int数组 0: 女性,1: 男性,如有多个人脸,则依次返回性别 [0]
age int数组 年龄0-100,如有多个人脸,依次返回年龄 [31]
expression int数组 2种表情,0:中性,1:微笑 [0]
glass int数组 是否佩戴眼镜,0:无眼镜,1:有眼镜 [0]
dense_fea_len int 人脸识别返回特征维度,目前固定为1024 1024
dense_fea float数组 人脸识别返回特征;如有多个人脸,则依次顺延,返回特征 [0.973859787, -1.28623402,……]

错误码说明

参见错误码

本文导读目录