检测和返回图片中人脸的坐标位置，以及面部特征的常见属性。

接口说明

超时时间建议设置为8S，减少因图片下载时间过长而导致的检测失败

鉴权说明

易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/facedetect/check
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

名称	类 型	必填	最大长度	描述
picType	Number	是	4	图片类型：1-URL，2-BASE64
picImage	String	是	256或10M	待检测照片

请求体示例

picType=1&picImage=xxx&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

响应

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

参数名称	类型	必须返回	描述
status	Number	是	检测结果，1-检测成功， 2-检测失败，3-图片下载失败，4-图片格式错误，5-其他错误，请联系客服
requestId	String	是	本次请求数据标识，可以根据该标识查询数据最新结果
faceNumber	Number	是	人脸数量
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费
faceLocations	Object	否	人脸的位置及人脸属性信息，具体结构如下表。随AI能力发展，该字段会扩充更多的检测能力，字段会随时间增加，请客户做好代码兼容准备
∟ x1	String	否	人脸位置信息，对应人脸矩形左上角横坐标相对坐标
∟ y1	String	否	人脸位置信息，对应人脸矩形左上角纵坐标相对坐标
∟ x2	String	否	人脸位置信息，对应人脸矩形右下角横坐标相对坐标
∟ y2	String	否	人脸位置信息，对应人脸矩形右下角纵坐标相对坐标
∟ gender	String	否	人脸性别，男性返回male，女性返回female，不可识别时返回空值
∟ age	Integer	否	人脸年龄，返回具体年龄数值，不可识别时返回空值
∟ type	String	否	人脸类型 , normal-普通 cartoon-卡通脸。 仅判断人脸照是否被卡通/漫画化，如果传的是纯卡通漫画照片，那么人脸个数会直接为0。
∟ sizeRatio	String	否	人脸占比百分比。 用于判断头像质量，正常的人像照片人脸占比在8-15%。若数值在4%及以下就属于质量不佳的人脸照片，建议让用户重新上传或进入您自己的人工审核流程
∟ maskType	String	否	mask(有遮挡)，normal（无遮挡）。 判断人脸是否有遮挡，可以用于判断用户是否佩戴口罩、纱巾等综合性遮挡场景
∟ glasses	String	否	人脸戴眼镜，normal(无眼镜)、 glasses(普通眼镜)、 sunglasses（墨镜）
∟ beautyScore	String	否	颜值分，范围0-1，分数越高，颜值越高

响应体实例：

{
	"msg": "ok",
	"result": {
		"faceLocations": [{
			"glasses": "normal",
			"maskType": "normal",
			"gender": "female",
			"sizeRatio": "30.46%",
			"y1": "0.1432",
			"x1": "0.1259",
			"y2": "0.5229",
			"x2": "0.928",
			"type": "normal",
			"age": "23",
                        "beautyScore": "0.57"
		}],
		"requestId": "ce21453dc6c94594999d4a852b7dff95",
		"isPayed": 1,
		"faceNumber": 1,
		"status": 1
	},
	"code": 200
}

响应返回码

响应返回码见：响应返回码