跳到主要内容

人脸比对

1. 任务简介​

1.1 任务 ID​

573e9604612013c0611d98f9

提示

任务 ID 全局固定且不变，建议客户将其定义为代码常量。

1.2 能力介绍​

  • 可对不同图片中的人脸进行对比，判断是否同一个人。
注意

注意：图片张数必须大于或等于 2 ，第一张是基准图，其余是对比图，识别结果是每张对比图分别与基准图的相似度。

2. 请求参数​

图片接口公共请求参数详见：图片同步识别接口，图片异步识别接口

视频接口公共请求参数详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3. 返回结果​

3.1 公共返回结果​

图片接口公共返回结果详见：图片同步识别接口，图片异步识别接口

视频接口公共返回结果详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3.2 任务返回结果​

任务结果​

参数名称类型是否必需说明
nameString是基准图名称。如果上传的 image 参数是 url ，则该值是图片 url ；如果是以图片文件上传，则该值为文件名
locationArray是基准图被检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标], 坐标值是相对于图片大小的百分比形式
relativesArrays是对比图的结果
tagString否调用时为该图片设置的 tag 参数

Relatives 参数​

参数名称类型是否必需说明
nameString是对比图名称。如果上传的 image 参数是 url，则该值是图片 url；如果是以图片文件上传，则该值为文件名
similarityNumber是与基准图的相似度，范围在 [0-100] 之间，分值越高，越相似
locationArray是检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标], 坐标值是相对于图片大小的百分比形式
labelNumber是对比结果，详见任务返回标签说明
reviewBoolean是是否复审
tagString否调用时为该图片设置的 tag 参数

任务返回标签说明​

label 值说明
0不相似
1难以判断
2相似
-1处理失败

3.3 响应示例​

{
  "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
}