Skip to content
当前页面

人脸质量提取

功能简介

  • 能力说明:对于输入的一张人像图(可正常解码,且长宽比适宜)对其中包含的人脸进行系统的ai算法检测并进行人脸质量置信度判断。 返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。
  • 支持数量:支持多张人像图。
  • 支持像素:最小支持50x50 像素,最大无限制。

AI能力集成

  • 外部应用最多只需调用两个接口,就可以完成一次AI能力集成,对不同图像识别能力,接口是固定的:其一是识别能力接口,其二是用户反馈接口

识别能力接口

参数
Content-Typemultipart/form-data
  • Body参数

    "file": "图片文件",
    "baseLs": "图片BASE64编码"
    
  • 请求参数说明

*参数名**是否必传**类型**说明*
fileYfile图片文件
baseLsNstring图片的BASE64编码(与file二传一即可), 不含BASE64头
  • 返回参数
{
  {
  ​    "face_quality": [
  ​      {
  ​        "rect": {//第一张人脸
  ​          "w": 71,
  ​          "h": 95,
  ​          "x": 377,
  ​          "y": 107
  ​        },
  ​        "qualities": [
  ​          1,
  ​          1,
  ​          0,
  ​          0,
  ​          0
  ​        ]
  ​      },
  ​      {
  ​        "rect": {//第二张人脸
  ​          "w": 71,
  ​          "h": 98,
  ​          "x": 191,
  ​          "y": 92
  ​        },
  ​        "qualities": [
  ​          2,
  ​          1,
  ​          0,
  ​          0,
  ​          0
  ​        ]
  ​      }
  ​    ]
  }
}
  • 返回参数说明
*参数名**类型**说明*
messageYstring返回描述
statusYintcode状态码
dataYobject返回JSON对象
+resultYstring算法层执行结果
+face_qualityYobject[]人脸质量信息数组
++rectYobject人脸质量对应的人头框体,xy,定位在图中的坐标,w表示宽度,h表示高度即可绘制人头框体
++qualitiesYobject人脸质量,一共5个元素,每个元素取值1与0,1表示有该质量,0则无,质量对照值见下表

返回结果中的data.face_quality[x],x元素的对应属性

*qualities-1:第一个参数*

*NAME**VALUE**人脸质量说明*
ML_NO_ANGLE0无角度
ML_LITTLE_ANGLE1小角度
ML_BIG_ANGLE2大角度

*qualities-2:第二个参数*

*NAME**VALUE**人脸质量说明*
ML_NO_EXPRESSION0无表情
ML_LITTLE_EXPRESSION1小表情
ML_LARGE_EXPRESSION2大表情

*qualities-:3第三个参数*

*NAME**VALUE**人脸质量说明*
ML_CLEAR0清晰
ML_LITTLE_BLUR1轻模糊
ML_BLUR2模糊
ML_BIG_BLUR2重模糊

*qualities-4:第四个参数*

*NAME**VALUE**人脸质量说明*
ML_FULL_FACE0完整
ML_PART_FACE1不完整

*qualities-5:第五个参数*

*NAME**VALUE**人脸质量说明*
ML_FACE0人脸
ML_NOT_FACE1非人脸

用户反馈接口

  • 接口说明

    用户在调用识别能力后,需要反馈识别能力识别的信息是否准确。用户反馈接口和能力识别接口通过业务流水号唯一标识进行关联。

    • 调用URL:

      https://aicp.teamshub.com/feedback/sitech/feedbackInformation

      Header:

      参数
      Content-Typeapplication/json
      tokenstring

      调用方法:

      post

      请求参数:

      参数名类型是否必选参数说明
      serialNumberString业务流水号
      jobNumberString业务工单号
      informationString用户修正信息(转义的json字符串,每个能力不同)
      modifyFlagBoolean修改标记(true 已修改,false 未修改)
      feedbackFlagBoolean反馈标识 (true为正确,false为错误)
      timeString工单发生时间,不填默认查当天

      请求报文示例:

       {
        "serialNumber":"8063200944317145088",
        "jobNumber":"test_jobNumber",
         "time":"2021-03-25",
         "modifyFlag":true,
         "feedbackFlag":false,
         "information":"{}"
      }
      

      返回值描述:

      参数名类型参数说明
      flagBoolean成功标识
      resultCodeLong状态码
      messageString返回信息
      dataJSON返回结果
      serialNumberString业务流水号

      成功返回示例:

      {
         "flag": true,
         "resultCode": 0,
         "message": "系统处理正常",
         "data": {
             "xxx":""
         }
      }
      

      失败返回示例:

      {
          "flag": false,
          "resultCode": 1,
          "message": "服务端报错",
          "data": null
      }
      

文档中心