跳转到内容

人脸比对

分析两张人脸是否属于同一个人的可能性。使用我们的人脸匹配技术,您将获得我们关于是否为同一人的判断以及相似度评分。

代码示例:

curl --location --request POST 'https://api.ekycpro.com/v1/facecompare' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img1=BASE64_ENCODE_VALUE' \
--data-urlencode 'img2=BASE64_ENCODE_VALUE'

同一人的响应示例

{
"status": "OK",
"message": {
"similarity": 97.501,
"result": "SAME PERSON"
}
}

不是同一人的响应示例

{
"status": "OK",
"message": {
"similarity": 27.501,
"result": "NOT SAME PERSON"
}
}

不确定的响应示例

{
"status": "OK",
"message": {
"similarity": 50.501,
"result": "NOT SURE"
}
}

错误请求的响应示例

{
"status": "INVALID_REQUEST",
"message": "error message"
}

上传的图片大于 2M 的响应示例

{
"status": "IMAGE_INVALID_SIZE",
"message": "image larger than 2M"
}

无法检测到人脸的响应示例

{
"status": "RETRY_LATER",
"message": "image detect face fail"
}

服务器错误的响应示例

{
"status": "INNER_ERROR",
"message": "Inner error, please retry later"
}

HTTP 请求

POST https://api.ekycpro.com/v1/facecompare title: 人脸比对 description: 分析两张人脸是否属于同一个人的可能性。


请求参数

参数描述
img1string,第一张以 base64 编码格式的图片
img2string,第二张以 base64 编码格式的图片

响应格式

字段描述
status状态码
messagesimilarity: 相似度评分,0~100
result: 判断结果

状态码

状态码描述
OKcharge,成功,message.similarity 包含相似度评分
RETRY_LATERcharge,无法检测到人脸
INVALID_REQUESTfree,无效的请求参数
IMAGE_INVALID_SIZEfree,图片大小超过 2M
INNER_ERRORfree,服务器错误

判断结果描述

以下分数为参考值。为了提高模糊图像的接受率,在实际使用中建议适当调整分数。

判断结果描述
SAME PERSON分数 >= 65 且 <= 100,表示两张图片属于同一个人
NOT SURE分数 >= 45 且 < 65,表示无法确定判断结果
NOT SAME PERSON分数 >= 0 且 < 45,表示两张图片属于不同的人