# 人脸比对将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取像素面积占比最大的人脸进行比对。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

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

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

请求头部：

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

请求参数：

{ 
    "image1":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...",
    "image2":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
}

请求参数说明

参数	必选	参数类型	说明
image1	是	String	图像数据，Base64编码，要求： Base64编码后大小建议小于1MB，不超过8MB。图片为JPG/JPEG/BMP/PNG格式。
image2	是	String	图像数据，Base64编码，要求： Base64编码后大小建议小于1MB，不超过8MB。图片为JPG/JPEG/BMP/PNG格式。

请求示例：

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

响应格式说明

返回结果

正常返回结果

{
    "code": "0",
    "data": {
        "image1_face": {
            "bounding_box": {
                "width": 174,
                "top_left_y": 37,
                "top_left_x": 22,
                "height": 174
            }
        },
        "similarity": 0.4078676104545593,
        "image2_face": {
            "bounding_box": {
                "width": 118,
                "top_left_y": 28,
                "top_left_x": 94,
                "height": 118
            }
        }
    },
    "error": "",
    "message": "ok"
}

异常返回结果

人脸比对失败响应示例

{
    "code": "58004",
    "data": null,
    "error": "Detect no face, check out your picture.",
    "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 数据结构

参数	必选	参数类型	说明
image1_face	是	Object	第1幅图像中检测到的人脸，DetectFace结构见DetectFace。
image2_face	是	Object	第2幅图像中检测到的人脸，DetectFace结构见DetectFace。
similarity	是	Double	人脸相似度，1表示最大，0表示最小，值越大表示越相似。一般情况下超过0.93即可认为是同一个人。

DetectFace 数据结构

名称	必选	类型	说明
bounding_box	是	BoundingBox object	人脸在图像中的位置。 BoundingBox结构见BoundingBox。

BoundingBox 数据结构

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

错误码说明

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

响应格式说明

结果。 ""

无结果。 ""