人脸对比

服务返回信息的公共结构

参数名	类型	是否必有	说明
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	不相似
2	相似

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
}

results matching ""

No results matching ""