AIPAAS文档中心

Appearance

Return to top
当前页面

人脸检测新

功能简介

  • 能力说明:检测图像中的所有人脸并返回每个人脸的位置信息 并根据用户需求，一并返回对应的属性，质量信息（支持多人脸检测）。
  • 适用范围:支持单张图片多人脸检测，最小支持 25x25 像素,最大无限制。

AI 能力集成

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

识别能力接口

  • 接口说明

    输入一张图片，检测图像中的所有人脸并返回每个人脸的位置信息 。

  • 接口 URL

    https://aicp.teamshub.com/sitech/aiopen/DetectMore

  • 访问方式

    POST

  • 接口头部参数

    Content-Type:application/json token:"token" 注：可用的 token 需要联系管理员进行申请

参数值
Content-Typemultipart/form-data

  • Body 参数

    请求示例
  "multi": true,
  "respAttr": true,
  "respQuality": true,
  "baseLs": "图片BASE64编码"

  • 请求参数说明

**参数名****是否必传****类型****说明**
multiNbool是否检测多个人脸（默认只返回最大人脸的结果）
respAttrNbool是否返回人脸的属性（默认不返回），属性对应表见人脸属性对照索引
respQualityNbool是否返回人脸的质量信息（默认不返回 质量维度详见质量维度对照表）
fileYfile要求图片格式：JPG(JPEG)，PNG 图片文件大小：5M 以内,因网络带宽等因素会影响处理结果图片内人脸数:<=60
baseLsNstring图片的 BASE64 编码(与 file 二传一即可), 不含 BASE64 头
  • 返回参数
   {
   "data": {
    "detect": {
     "result": "ok",
     "face_boxs": [
  ​    [
  ​     {
  ​      "width": 205,
  ​      "x": 44,
  ​      "y": 74,
  ​      "height": 277
  ​     },
  ​     {
  ​      "width": 145,
  ​      "x": 239,
  ​      "y": 480,
  ​      "height": 191
  ​     }
  ​    ]
     ]
    },
    "attr": {
     "FaceAttrs": [
  ​    {
  ​     "rect": {
  ​      "w": 205,
  ​      "h": 277,
  ​      "x": 44,
  ​      "y": 74
  ​     },
  ​     "attributes": [
  ​      {
  ​       "score": 0.8100211024284363,
  ​       "index": 8
  ​      },
  ​      {
  ​       "score": 0.814797043800354,
  ​       "index": 15
  ​      },
  ​      {
  ​       "score": 0.7406783699989319,
  ​       "index": 20
  ​      },
  ​      {
  ​       "score": 0.25958698987960815,
  ​       "index": 23
  ​      },
  ​      {
  ​       "score": 0.980000913143158,
  ​       "index": 24
  ​      },
  ​      {
  ​       "score": 0.41882821917533875,
  ​       "index": 32
  ​      },
  ​      {
  ​       "score": 0.9355862140655518,
  ​       "index": 37
  ​      }
  ​     ]
  ​    },
  ​    {
  ​     "rect": {
  ​      "w": 145,
  ​      "h": 191,
  ​      "x": 239,
  ​      "y": 480
  ​     },
  ​     "attributes": [
  ​      {
  ​       "score": 0.9164742827415466,
  ​       "index": 8
  ​      },
  ​      {
  ​       "score": 0.8797747492790222,
  ​       "index": 15
  ​      },
  ​      {
  ​       "score": 0.9683481454849243,
  ​       "index": 20
  ​      },
  ​      {
  ​       "score": 0.970066487789154,
  ​       "index": 24
  ​      }
  ​     ]
  ​    }
     ],
     "result": "ok"
    },
    "quality": {
     "result": "ok",
     "face_quality": [
  ​    {
  ​     "rect": {
  ​      "w": 205,
  ​      "h": 277,
  ​      "x": 44,
  ​      "y": 74
  ​     },
  ​     "qualities": [
  ​      2,
  ​      0,
  ​      1,
  ​      0,
  ​      0
  ​     ]
  ​    },
  ​    {
  ​     "rect": {
  ​      "w": 145,
  ​      "h": 191,
  ​      "x": 239,
  ​      "y": 480
  ​     },
  ​     "qualities": [
  ​      0,
  ​      0,
  ​      0,
  ​      0,
  ​      0
  ​     ]
  ​    }
     ]
    }
   },
   "message": "OK",
   "status": 200
  }
  • 返回参数说明

提示：配合结果集中 x,y,width,height 可以绘制一个正方形框，x,y 确定一个起点

**参数名****类型****说明**
messageYstring返回描述
statusYintcode 状态码
dataYobject检测返回结果对象
+detectYobject检测出的人像框坐标集合
++resultYstring算法层执行结果
++face_boxsYlist返回人脸框的集合
+++widthYint头像框宽
+++xYint头像 x 轴起点
+++yYint头像 y 轴起点
+++heightYint头像框高
+attrNobject检测出的人像框坐标集合
++resultYstring算法层执行结果
++FaceAttrsYstring人像对应的描述集合
+++rectYlist返回人脸框的集合
++++widthYint头像框宽
++++xYint头像 x 轴起点
++++yYint头像 y 轴起点
++++heightYint头像框高
+++attributesYlist检测出人像的描述集合
++++scoreYfloat返回属性的置信度 范围 0~1
++++indexYint属性索引对照，请参见人脸属性索引对照表
+qualityNobject检测出的人像框坐标集合
++resultYstring算法层执行结果
++face_qualityYobject[]人脸质量信息数组
+++rectYobject人脸质量对应的人头框体,xy,定位在图中的坐标,w 表示宽度,h 表示高度即可绘制人头框体
+++qualitiesYobject人脸质量，一共 5 个元素，每个元素取值 1 与 0,1 表示有该质量，0 则无,质量对照值见下表

人脸质量多维对照表

**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
}

文档中心

Copyright © 2022-present aipaas