跳转到内容
eKYC Pro API 文档

人脸比对

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

代码示例：

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，表示两张图片属于不同的人

Products