文档中心 > 人脸相似度对比
人脸相似度对比

最近更新时间:2021-08-26

1 功能描述


人脸相似度对比用于对比两张图像中的人脸信息,分析人脸特征,返回人脸相似度评分。

您上传两张图片,服务会对比两张图片中人脸相似度(如果无图片或图片中有多张人脸,暂不支持),并返回相似度评分。

2 请求说明

2.1 请求方式

调用地址:https://apim.unicloud.com/api/face/compare/1.0.0/

请求方式:POST

返回类型:JSON

2.2 请求参数

Header如下:

参数说明
Content-Typeapplication/json--
AuthorizationBearer参考Token获取

Body如下:

参数是否必选类型可选值范围说明
img_1truefile--人脸图片(支持jpg、jpeg、png格式),图片中需保证只有一个人
img_2truefile--人脸图片(支持jpg、jpeg、png格式),图片中需保证只有一个人

注:Body使用form-data形式

2.3 请求示例

curl -k  -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \
    -F "img_1=@imgpath1.jpg" -F "img_2=@imgpath2.jpg" https://apim.unicloud.com/api/face/compare/1.0.0/

3 返回说明

3.1 返回参数

字段类型说明
dataobject人脸对比数据
+confidencesfloat置信度,此参数是以百分百展示,推荐阈值为50,越接近100越可信
codeint返回码(200:接口调用成功,400:文件格式错误或非法数据,500:程序异常退出)
messagestring提示信息

3.2 返回示例

{  
    "data": {    
        "confidences": 86.1           
  },    
  "code": 200,    
  "message": "success"
}