文档首页 > > API参考> 人脸识别API(V2)> 人脸比对

人脸比对

分享
更新时间: 2020/01/16 GMT+08:00

功能介绍

将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。

约束限制:
  • 人脸比对输入的两张图片总大小小于8MB。
  • 只支持识别JPG、PNG、JPEG、BMP格式的图片。
  • application/json请求的body中,请使用标准Json格式。
  • Base64编码中请勿使用回车换行。
  • 系统不保存用户图片。
  • 图片大小小于8MB,由于过大图片会导致时延较长,并且图片信息量不大,建议小于1MB
  • 图片分辨率小于4096*2160,图片中人脸像素大于80*80,建议120*120以上。
  • 为保证识别效果,人脸图片建议要求如下:
    1. 光照大于200lux、无反光强光阴影现象。
    2. 人脸无遮挡、整体清晰无拖尾抖动等运动模糊。
    3. 侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。
  • 具体的约束限制信息请参见约束限制章节。
建议:
  • 由于过大图片对识别算法精度无明显提升,同时会导致时延较长,建议传入图片小于1MB,一般500KB左右足够。
  • OBS上存储的图片也建议小于1MB
  • 图片中人脸像素建议120*120以上。

URI

  • URI格式
    POST /v2/{project_id}/face-compare
  • 参数说明

    参数名

    参数类型

    是否必选

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID/账号名/AK/SK

请求消息

表1 请求参数

参数名

参数类型

是否必选

说明

image1_url

String

与image1_file、image1_base64三选一

图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权

image1_file

File

与image1_url、image1_base64三选一

本地图片文件,图片不能超过8MB,建议小于1MB。上传文件时,请求格式为multipart。

image1_base64

String

与image1_file、image1_url三选一

图像数据,Base64编码,要求:
  • Base64编码后大小不超过8MB,建议小于1MB
  • 图片为JPG/JPEG/BMP/PNG格式。

image2_url

String

与image2_file、image2_base64三选一

图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权

image2_file

File

与image2_url、image2_base64三选一

本地图片文件,图片不能超过8MB,建议小于1MB。上传文件时,请求格式为multipart。

image2_base64

String

与image2_file、image2_url三选一

图像数据,Base64编码,要求:
  • Base64编码后大小不超过8MB,建议小于1MB
  • 图片为JPG/JPEG/BMP/PNG格式。

响应消息

表2 响应参数

参数名

参数类型

说明

image1_face

DetectFace object

第1幅图像中检测到的人脸。DetectFace结构见DetectFace

调用失败时无此字段。

image2_face

DetectFace object

第2幅图像中检测到的人脸。

调用失败时无此字段。

similarity

Double

人脸相似度,1表示最大,0表示最小,值越大表示越相似。一般情况下超过0.93即可认为是同一个人。

调用失败时无此字段。

error_code

String

调用失败时的错误码,具体请参考错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求样例(方式一:使用图片的BASE64编码)
    POST https://{endpoint}/v2/{project_id}/face-compare
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
    
    Request Body:
    {
      "image1_base64":"/9j/4AAQSkZJRgABAgEASABIAAD",
      "image2_base64":"/9j/4AAQSkZJRgABAgEASABIAAD"
    }
  • 请求样例(方式二:使用图片文件)
    POST https://{endpoint}/v2/{project_id}/face-compare
    Request Header:
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
    
    Request Body:
    image1_file: File(图片文件)
    image2_file: File(图片文件)
  • 请求样例(方式三:使用图片url)
    POST https://{endpoint}/v2/{project_id}/face-compare
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
    
    Request Body:
    {
      "image1_url":"/BucketName/ObjectName",
      "image2_url":"/BucketName/ObjectName"
    }
  • 响应样例
    {
      "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_code": "FRS.0501",
      "error_msg": "Detect no face, check out your picture."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区