文档中心 > API类目 > 视觉开放API(viapi)

aliyun.viapi.facebody.recognizeface (人脸属性识别)

输入图片之后,在人脸检测定位返回结果的基础上,识别各个检测人脸的四种属性,返回性别(男/女)、年龄、表情(笑/不笑)、眼镜(戴/不戴);并可返回人脸的1024维深度学习特征。(参数图片/链接必须通过以下方式获取: https://help.aliyun.com/document_detail/155645.html )

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
image_url String 可选 http://xx.xxx.com/a.jpeg 待检测图片链接
image_type Number 可选 0 图片类型, ,取值范围[0:ImageURL, 1:ImageContent]

响应参数

名称 类型 示例值 描述
taobao_request_id String 83FFDEFE-F863-4490-8C8F-165CFFC1954F 请求ID
data Data {} 系统自动生成
  • └ face_rectangles
  • Number []
  • 222,333,444
  • 返回人脸矩形框,分别是[left, top, width, height], 如有多个人脸,则依次顺延,返回矩形框。如有两个人脸则返回[left1, top1, width1, height1, left2, top2, width2, height2]
  • └ dense_feature_length
  • Number
  • 1024
  • 人脸识别返回特征维度,目前固定为1024
  • └ pose_list
  • String []
  • 34.3,290.2,297.3
  • 返回人脸姿态[yaw, pitch, roll], yaw为左右角度,取值[-90, 90],pitch为上下角度,取值[-90, 90], roll为平面旋转角度,取值[-180, 180],如有多个人脸,则依次顺延
  • └ pupils
  • String []
  • 296.3
  • 左右两个瞳孔的中心点坐标和半径,每个人脸6个浮点数,顺序是[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]
  • └ gender_list
  • Number []
  • 1
  • 0: 女性,1: 男性,如有多个人脸,则依次返回性别
  • └ dense_features
  • String []
  • 1024
  • 人脸识别返回特征;如有多个人脸,则依次顺延,返回特征
  • └ face_probability_list
  • Number []
  • 0.9899,0.2879
  • 返回人脸概率, 0-1之间,如有多个人脸,则依次顺延。如有两个人脸则返回[face_prob1, face_prob2]
  • └ landmark_count
  • Number
  • 105
  • 特征点数目,目前固定为105点(顺序:眉毛24点,眼睛32点,鼻子6点,嘴巴34点,外轮廓9点)
  • └ age_list
  • Number []
  • 18
  • 年龄0-100,如有多个人脸,依次返回年龄
  • └ glasses
  • Number []
  • 0
  • 是否佩戴眼镜,0:无眼镜,1:有眼镜
  • └ landmarks
  • String []
  • 318.34,198.27
  • 特征点定位结果,每个人脸返回一组特征点位置,表示方式为(x0, y0, x1, y1, ……);如有多个人脸,则依次顺延,返回定位浮点数
  • └ expressions
  • Number []
  • 0
  • 2种表情,0:中性,1:微笑
  • └ face_count
  • Number
  • 1
  • 检测出来的人脸个数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliyunViapiFacebodyRecognizefaceRequest req = new AliyunViapiFacebodyRecognizefaceRequest();
req.setImageUrl("http://xx.xxx.com/a.jpeg");
req.setImageType(0L);
AliyunViapiFacebodyRecognizefaceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliyun_viapi_facebody_recognizeface_response>
    <taobao_request_id>83FFDEFE-F863-4490-8C8F-165CFFC1954F</taobao_request_id>
    <data>
        <face_rectangles>
            <number>222</number>
            <number>333</number>
            <number>444</number>
        </face_rectangles>
        <dense_feature_length>1024</dense_feature_length>
        <pose_list>
            <string>34.3</string>
            <string>290.2</string>
            <string>297.3</string>
        </pose_list>
        <pupils>
            <string>296.3</string>
        </pupils>
        <gender_list>
            <number>1</number>
        </gender_list>
        <dense_features>
            <string>1024</string>
        </dense_features>
        <face_probability_list>
            <number>0.9899</number>
            <number>0.2879</number>
        </face_probability_list>
        <landmark_count>105</landmark_count>
        <age_list>
            <number>18</number>
        </age_list>
        <glasses>
            <number>0</number>
        </glasses>
        <landmarks>
            <string>318.34</string>
            <string>198.27</string>
        </landmarks>
        <expressions>
            <number>0</number>
        </expressions>
        <face_count>1</face_count>
    </data>
</aliyun_viapi_facebody_recognizeface_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部