人脸对比1:1
人脸比对是将两个人脸进行比对,来判断是否为同一个人,返回相似度。如果传入的图片中包含多个人脸,选取人脸质量最高的进行比对。
接口调用说明
请求地址 : /v1/api/frs/face/compare
请求方式 : POST
请求头
参数名 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
X-Token | 实际accessToken | 是 |
请求报文体
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
imgUrlA | String | 否 | 图A的url地址 |
imgUrlB | String | 否 | 图B的url地址 |
imgBase64A | String | 否 | 图A的base64数据 |
imgBase64B | String | 否 | 图B的base64数据 |
允许用户上传2张图片进行人脸对比,图片可以通过url
,base64
上传,参数中A,B表示2张图片,不可以imgUrlA,imgBase64A
或者imgUrlB,imgBase64B
这种组合方式上传
示例数据
HTTP/1.1 200 OK
Content-Type:application/json
X-Token: eyJ0eXAiOiJKV1Q.***.hkdsfiYHFDJKDFQPEO
{
"imgUrlA":"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png",
"imgUrlB":"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/2.png",
"imgBase64A":"",
"imgBase64B":""
}
响应报文
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
code | Integer | 是 | 状态码 |
msg | String | 是 | 状态码解释信息 |
data | Object | 是 | 返回内容(详情见下表) |
data内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
similarity | number | 是 | 人脸相似度,1表示最大,0表示最小,值越大表示越相似 |
示例数据
HTTP/1.1 200 OK
Content-Type:application/json
{
"code":1000,
"msg":"success",
"data":{
"similarity":0.97858
}
}