API文档目录

人脸1v1比对

  • 接口说明

对比两张图片中人脸的相似度

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/comparision

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 targetImage Object true 目标图片(图片像素在48*48-1600W内,文件大小在128字节-8M内。图片类型限制为:png、jpg/jpeg、bmp 。)
  imageUrl String false 图片访问地址,imageUrl与imageData二选一填写,但当两者都存在的时候,默认使用imageUrl(url需要进行encode编码,防止出现特殊字符) http://ip:port/img/545a1de.jpg
  imageData String false 图片数据通过Base64编码后的字符串,imageUrl与imageData二选一填写,但当两者都存在的时候,默认使用imageUrl data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD
 contrastImage Object true 对比图片(图片像素在48*48-1600W内,文件大小在128字节-8M内。图片类型限制为:png、jpg/jpeg、bmp 。)
  imageUrl String false 图片访问地址,imageUrl与imageData二选一填写,但当两者都存在的时候,默认使用imageUrl(url需要进行encode编码,防止出现特殊字符) http://ip:port/img/545a1de.jpg
  imageData String false 图片数据通过Base64编码后的字符串,imageUrl与imageData二选一填写但当两者都存在的时候,默认使用imageUrl data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD
  • 入参举例
{
   “targetImage”: {
     “imageUrl”: “http://ip:port/img/545a1de.jpg”,
     “imageData”: “data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD”
  },
   “contrastImage”: {
     “imageUrl”: “http://ip:port/img/545a1de.jpg”,
     “imageData”: “data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD”
  }
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码,0表示成功,其他表示失败 false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  similarity Number 相似度, float类型,取值范围[0,1] false 0.7356
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “similarity”: 0.7356
  }
}