DetectFaceAttributes_实人认证-阿里云帮助中心

请求方法：仅支持以HTTPS POST方法发送请求。

接口描述：对输入照片中人脸的有效性相关属性进行检测，便于业务方判定该照片是否满足自身业务留存或比对的要求。目前支持的人脸有效性相关属性有：是否人脸、是否模糊、是否戴眼镜、脸部姿态、是否笑脸等。

上传图片地址的说明：在传入图片时，您需要上传其对应的HTTP、OSS地址或Base64编码。

HTTP地址：可访问的公网HTTP地址。例如，http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg。
Base64编码：通过base64编码的图片，格式为base64://<图片 base64 字符串>。

图片限制：

不支持本地图片的相对路径或绝对路径。
单张图片大小请控制在2 MB内，避免算法拉取超时。
单个请求的Body有8 MB的大小限制，请计算好请求中所有图片和其他信息的大小，不要超限。
使用Base64传递图片时，接口的请求方法需要改成 POST；图片Base64字符串需要去掉头部描述，如data:image/png;base64。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DetectFaceAttributes	要执行的操作。取值：DetectFaceAttributes。
MaterialValue	String	是	http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg	待检测照片，格式描述见上传图片地址的说明。同一张图片最多检测其中的5张人脸。
BizType	String	否	RPBasicTest	使用实人认证服务的业务场景标识。

返回数据


名称	类型	示例值	描述
Code	String	200	HTTP状态码。
Data	Struct		返回数据。
FaceInfos	Array of FaceAttributesDetectInfo		人脸检测结果。
FaceAttributesDetectInfo
FaceAttributes	Struct		人脸属性。
Blur	Float	0.1419367790222168	人脸模糊度，分值越大越模糊。通常≥2.0已较模糊，建议根据实际业务数据测试调整。
Facequal	Float	60	表示分数，取值范围：0~100。分数越高，质量越好，建议您使用大于或者等于50分认为质量合格。
Facetype	String	Face	是否人脸。取值： None：不是人脸 Face：人脸 Profile：侧脸（左右转头超过30°）说明若没有检测到人脸，接口返回的faceInfos即为空；这里的None代表检测到人脸，但认为是卡通或宠物等。
Glasses	String	None	是否戴眼镜。取值： None：未戴眼镜 Wear：戴普通眼镜 Sunglass：戴墨镜
Headpose	Struct		人脸姿态。
PitchAngle	Float	-1.5683923959732056	抬头角度，单位为度。
RollAngle	Float	7.163370132446289	左右歪头角度，单位为度。
YawAngle	Float	-6.925303936004639	左右转头角度，单位为度。
Integrity	Integer	70	表示分数，取值范围：0~100。分数越高，人脸越完整，建议您使用大于等于70分为完整度合格。
Respirator	String	Wear	是否戴口罩。取值： Wear：表示戴口罩。 None：表示没有戴口罩。
Smiling	Struct		是否笑脸。
Threshold	Float	95	笑脸阈值。
Value	Float	97	笑脸分值。
FaceRect	Struct		人脸在原图中的位置。
Height	Integer	473	人脸矩形的高度。
Left	Integer	354	人脸矩形左上角距原图左边的距离，单位为像素。
Top	Integer	453	人脸矩形左上角距原图上边的距离，单位为像素。
Width	Integer	473	人脸矩形的宽度。
ImgHeight	Integer	1920	原图高度，单位为像素。
ImgWidth	Integer	1080	原图宽度，单位为像素。
Message	String	Error.InternalError	错误代码。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	本次请求的ID。
Success	Boolean	true	是否成功响应。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectFaceAttributes
&MaterialValue=http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
&<公共请求参数>

正常返回示例

XML格式

<DetectFaceAttributesResponse>
	  <Code>200</Code>
	  <Data>
		    <FaceInfos>
			      <FaceAttributesDetectInfo>
				        <element>
					          <FaceAttributes>
						            <Blur>0.14193678</Blur>
						            <Facetype>Face</Facetype>
						            <Glasses>None</Glasses>
						            <Headpose>
							              <PitchAngle>-1.5683924</PitchAngle>
							              <RollAngle>7.16337</RollAngle>
							              <YawAngle>-6.925304</YawAngle>
						            </Headpose>
						            <Smiling></Smiling>
					          </FaceAttributes>
					          <FaceRect>
						            <Height>473</Height>
						            <Left>354</Left>
						            <Top>453</Top>
						            <Width>473</Width>
					          </FaceRect>
				        </element>
			      </FaceAttributesDetectInfo>
		    </FaceInfos>
		    <ImgHeight>1920</ImgHeight>
		    <ImgWidth>1080</ImgWidth>
	  </Data>
	  <Success>true</Success>
    </DetectFaceAttributesResponse>

JSON格式

{
        "Code": 200,
        "Data": {
            "FaceInfos": {
                "FaceAttributesDetectInfo": {
                    "element": {
                        "FaceAttributes": {
                            "Blur": 0.14193678,
                            "Facetype": "Face",
                            "Glasses": "None",
                            "Headpose": {
                                "PitchAngle": -1.5683924,
                                "RollAngle": 7.16337,
                                "YawAngle": -6.925304
                            },
                            "Smiling": ""
                        },
                        "FaceRect": {
                            "Height": 473,
                            "Left": 354,
                            "Top": 453,
                            "Width": 473
                        }
                    }
                }
            },
            "ImgHeight": 1920,
            "ImgWidth": 1080
        },
        "Success": true
}

错误码

访问错误中心查看更多错误码。