图片识别-人脸对比

HTTPS
识别两张图片中的人脸,返回两张人脸的相似度对比结果。
免费套餐
套餐 1
套餐 2
套餐 3
套餐 4
0 / 50 次

雷达评级

AA

用户规模

10 万+

产品上线

5

图片识别-人脸对比

接口地址
https://tupu.apistd.com/v3/recognition/face-comparison
请求格式
multipart/form-data
响应格式
application/json
请求方法
POST
请求参数 (Query)
参数类型必须描述
keystring
string
请求 AccessKey, 请在控制台中查看
请求参数 (Body)
参数类型必须描述
imagefile
string|file
1、支持传图片URL或者直接post图片文件,不过两者不能混在同一请求中;2、必须上传2个及以上数量的图片文件;3、只支持对静态图像的处理,如:png、jpg、jpeg、tif、webp,不支持动态图像的处理,如:gif;如需识别请参考视频识别;4、为了加快网络传输速度,图片大小必须在1M以内,且建议对图片进行压缩处理,等比压缩到[256, 512]之间。
tagstring
string
用于给图片或文本附加额外信息(比如:直播客户可能传房间号,或者主播ID信息)。方便后续根据tag搜索到相关的图片或文本。1、支持多个tag参数,和image或text参数一一对应;2、如果tag只有一个,或者tag数量少于image或text,缺省用最后一个tag补全(尾补全)。
refererstring
string
根据图片url下载图片时,将其赋值给HTTP Header的Referer,用于图片防盗链
返回参数 (Body)
参数类型描述
codenumber
number
请求的状态码
messagestring
string
请求的状态信息
timestampnumber
number
当前的服务器的Unix时间戳
noncenumber
number
随机数
dataobject
object
识别任务的结果
namestring
string
基准图名称。如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名
locationarray
array
基准图被检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标]
tagstring
string
调用时为该图片设置的tag参数
relativesarray
array
对比图的结果
namestring
string
对比图名称。如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名
similaritynumber
number
与基准图的相似度,范围在[0-100]之间,分值越高,越相似
locationarray
array
检测到的人脸坐标信息 [左上角坐标,右上角坐标,右下角坐标,左下角坐标]
labelnumber
number
对比结果 0 不相似 1 难以判断 2 相似
tagstring
string
调用时为该图片设置的tag参数
reviewboolean
boolean
是否复审
请求返回示例
{
  "data": {
    "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
}

图片识别-人脸对比-API接口介绍