# 人脸检测对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键点位置和人脸关键属性。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v2/frs/face-detect

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json
x-wlk-Authorization: access_token

请求参数：

{ 
    "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...",
    "attributes":"1,2"
}

请求参数说明：

参数	必选	参数类型	说明
image	是	String	图像数据，Base64编码，要求： Base64编码后大小建议小于1MB，不超过8MB。图片为JPG/JPEG/BMP/PNG格式。
attributes	否	String	是否返回人脸属性，希望获取的属性列表，多个属性间使用逗号（,）隔开。目前支持的属性有： 1：性别 2：年龄

请求示例：

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v2/frs/face-detect' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...", "attributes": "1,2"}'

响应格式说明

返回结果

正常返回结果

{
    "code": "0",
    "data": {
        "faces": [
            {
                "bounding_box": {
                    "width": 174,
                    "top_left_y": 37,
                    "top_left_x": 22,
                    "height": 174
                },
                "attributes": {
                    "age": 35,
                    "gender": "male"
                }
            }
        ]
    },
    "error": "",
    "message": "ok"
}

异常返回结果

人脸检测失败响应示例

{
    "code": "58004",
    "data": null,
    "error": "Recognize Failed",
    "message": "FRS service call exception"
}

Token验证失败响应示例

{
    "code": "58401",
    "data": null,
    "error": "Failed to verify the token.",
    "message": "Login authentication failed."
}

返回参数说明

参数	必选	参数类型	说明
code	是	String	错误码
message	是	String	调用成功时为"ok"。调用失败时的错误信息。
data	是	Object	调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error	是	String	错误信息。

data 数据结构

参数	必选	参数类型	说明
faces	是	Array [DetectFace]	检测到的人脸，DetectFace结构见DetectFace。

DetectFace 数据结构

名称	必选	类型	说明
bounding_box	是	BoundingBox object	人脸在图像中的位置。 BoundingBox结构见BoundingBox。
attributes	否	Attributes object	人脸关键属性，比如性别、年龄、头部姿态等。 Attributes结构见Attributes。

BoundingBox 数据结构

名称	必选	类型	说明
top_left_x	是	Integer	矩形框左上角横坐标。
top_left_y	是	Integer	矩形框左上角纵坐标。
width	是	Integer	矩形框宽度。
height	是	Integer	矩形框高度。

Attributes 数据结构

名称	必选	类型	说明
age	否	Integer	年龄
smile	否	String	笑脸
gender	否	String	性别： male：男 female：女 unknown：未知
dress	否	Array [String]	包含glass和hat两个属性结果。
glass	否	String	是否带眼镜： yes：带眼镜 dark：带墨镜 none：未戴眼镜 unknown：未知
hat	否	String	是否带帽子： yes：带帽子 none：未戴帽子 unknown：未知
headpost	否	Array [Double]	人脸轮廓坐标值。
pitch_angle	否	Double	围绕X轴旋转，俯仰角，范围[-180,180]。
roll_angle	否	Double	围绕Z轴旋转，翻滚角，范围[-180,180]。
yaw_angle	否	Double	围绕Y轴旋转，偏航角，范围[-180,180]。

错误码说明

错误码	说明
0	成功。
58401	无权限。
58402	非法参数异常。
58500	服务异常。
58004	FRS服务异常。

响应格式说明

结果。 ""

无结果。 ""