人脸对比
服务返回信息的公共结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
signature | String | 是 | 我们采用的数字证书签名算法是:"RSA-SHA256" ,签名输出类型是:"base64" ,首先下载图普科技的公钥证书,然后按如下步骤认证:1、收到的JSON数据经过JSON.parse(),得到JSON对象,记为data; 2、data含两个字段:signature、json;signature是数字签名,json是真正的有效数据的字符串格式; 3、用signature对json进行签名认证,算法: RSA-SHA256 ,输出类型:base64 ,得到认证结果;4、认证通过后,对json进行JSON.parse(),得到JSON数据,详见"json"字段说明。 |
json | String | 是 | json 字段经过JSON.parse(json)后,得到具体的结果,含: message:与code相关的文本信息 timestamp:当前的服务器的Unix时间戳。 nonce:随机数。 |
json内容解析后的结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
code | Number | 是 | 请求的状态码,参考服务公共状态码解析 |
message | String | 是 | 请求的状态信息 |
timestamp | Number | 是 | 当前的服务器的Unix时间戳 |
nonce | Number | 是 | 随机数 |
[taskId] | Object | 是 | 识别任务的结果,不同识别任务会有特定的taskId和[taskId]信息结构 |
... | ... | 否 | 其它识别及请求响应结果信息 |
示例
{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}
任务结果信息
taskId
573e9604612013c0611d98f9
图片使用与限制
图片张数必须大于或等于2,第一张是基准图,其余是对比图,识别结果是每张对比图分别与基准图的相似度。
taskId参数
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
name | String | 是 | 基准图名称。如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名 |
location | Array | 是 | 基准图被检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标] |
relatives | Arrays | 是 | 对比图的结果 |
tag | String | 否 | 调用时为该图片设置的tag参数 |
relatives参数
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
name | String | 是 | 对比图名称。如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名 |
similarity | Number | 是 | 与基准图的相似度,范围在[0-100]之间,分值越高,越相似 |
location | Array | 是 | 检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标] |
label | Number | 是 | 对比结果 |
review | Boolean | 是 | 是否复审 |
tag | String | 否 | 调用时为该图片设置的tag参数 |
label
label | 说明 |
---|---|
0 | 不相似 |
1 | 难以判断 |
2 | 相似 |
-1 | 处理失败 |
json示例
{
"573e9604612013c0611d98f9": {
"name": "base.jpg",
"location": [
[
0.109375,
0.026041666666666668
],
[
0.9791666666666666,
0.026041666666666668
],
[
0.9791666666666666,
0.8958333333333334
],
[
0.109375,
0.8958333333333334
]
],
"relatives": [
{
"name": "test1.mp4",
"similarity": 11.51,
"location": [
[
0,
0.232421875
],
[
1,
0.232421875
],
[
1,
0.86328125
],
[
0,
0.86328125
]
],
"label": 0
},
{
"name": "test2.mp4",
"similarity": 71.51,
"location": [
[
0,
0.232421875
],
[
1,
0.232421875
],
[
1,
0.86328125
],
[
0,
0.86328125
]
],
"label": 2
}
]
},
"code": 0,
"message": "success",
"nonce": "0.04379045612903143",
"timestamp": 1578885750581
}