添加人脸

添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，如果包含多张人脸，如果图片中包含多张人脸，仅将人脸质量分>=threshold添加到人脸库中。支持上传图片url，base64编码的2种图片上传方式

接口调用说明

请求地址 : /v1/api/frs/face/add
请求方式 : POST

约束限制

只支持识别jpeg, jpg, png, bmp格式的图片
Base64编码中请勿使用回车换行
系统不保存用户图片
图片大小<=2M

为保证识别效果，人脸图片建议要求如下

图片分辨率建议不超过1024*1024 ，人脸像素不低于60*60
建议正脸免冠，具备真实性
人脸完整，无遮挡、整体清晰无拖尾抖动等运动模糊
光照大于200lux、无反光强光阴影现象
侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸

请求头

参数名	参数值	是否必须
Content-Type	application/json	是
X-Token	实际accessToken	是

请求报文体

名称	类型	是否必须	备注
colName	String	是	人脸库名称，限制[3,32]个字符
dataType	String	是	数据类型 url : 图片URL; base64 : base64 编码的二进制图片数据
imgUrl	String	否	图片的下载地址，dataType=url时必填
imgBase64	String	否	图片的base64，dataType=base64时必填
imgId	String	否	用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符
extraFieldA	String	否	用户自定义字段A，length<32
extraFieldB	String	否	用户自定义字段B，length<32
extraData	String	否	自定义字段，平台透传该字段，方便自己的业务系统集成
qThreshold	Integer	否	质量分阈值，默认值=75。对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败，取值范围[50,100]

示例数据

HTTP/1.1 200 OK
Content-Type:application/json
X-Token: eyJ0eXAiOiJKV1Q.***.hkdsfiYHFDJKDFQPEO

{
    "colName":"default",
    "dataType":"url",
    "imgUrl":"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png",
    "imgBase64":"",
    "imgId":"32dfsdee56fgdw312fgf6767",
    "extraFieldA":"",
    "extraFieldB":"",
    "qThreshold":75,
    "extraData":"{\"sn\":\"12221SSS8H6D\"}"
}

响应报文

名称	类型	是否必须	备注
code	Integer	是	状态码
msg	String	是	状态码解释信息
data	Object	是	返回内容(详情见下表)

data内容如下:

名称	类型	是否必须	备注
faces	[]Object	是	返回的人脸列表 (详情见下表)
imgId	String	是	用户定义的imgId
extraFieldA	String	是	用户自定义字段A
extraFieldB	String	是	用户自定义字段B
extraData	String	否	用户自定义字段

faces内容如下:

名称	类型	是否必须	备注
faceId	Integer	是	人脸id
quality	Integer	是	人脸质量分,[0,100]
gender	String	是	性别：male-男 female-女
age	Integer	是	年龄：(0-6)分别对应区间(0~9,10-19,20~29,30~39,40~49,50~59,60~)
x	Integer	是	人脸坐标框x,单位像素
y	Integer	是	人脸坐标框y,单位像素
w	Integer	是	人脸坐标框w,单位像素
h	Integer	是	人脸坐标框h,单位像素
cover	Integer	是	是否戴口罩：0，没戴，1，戴

示例数据

HTTP/1.1 200 OK
Content-Type:application/json

{
  "code": 1000,
  "msg": "success",
  "data": {
    "faces": [
      {
        "faceId": 451538484897866697,
        "quality": 100,
        "gender": "male",
        "age": 4,
        "x": 169,
        "y": 140,
        "w": 279,
        "h": 403,
        "cover": 0
      }
    ],
    "imgId": "09e45ce69c4d48409782f3af61abd43d",
    "extraFieldA": "fcc5e7de46ac4e8b891277371cf5390f",
    "extraFieldB": "0d011967ee2b4c20a38eb2cd272070ef",
    "extraData": "{\"sn\":\"12221SSS8H4D\"}"
  }
}

添加人脸

添加人脸

results matching ""

No results matching ""