Skip to content
当前页面

人脸关键点检测

功能简介

  • 能力说明:检测图像中的所有人脸并返回每个人脸的核心关键点,包括眼睛、眉毛、嘴巴、鼻子以及人脸轮廓。适应大角度侧脸,部分遮挡,表情变化,明暗变化等各种实际环境
  • 适用范围:支持一张图,并且图片中只有多张人脸;最小支持 50x50 像素,最大无限制。

AI 能力集成

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

识别能力接口

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

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

**参数名****是否必传****类型****说明**
fileYfile图片文件
baseLsNstring图片的 BASE64 编码(与 file 二传一即可), 不含 BASE64 头
  • 返回参数
   {
     "status": 200,
     "message": "Request successful",
     "data": {
  ​      "FaceInfos" :
  ​      {
  ​       "boxs" :
  ​       [
  ​        {
  ​         "height" : 651,
  ​         "width" : 507,
  ​         "x" : 207,
  ​         "y" : 386
  ​        }
  ​       ],
  ​       "key_points" :
  ​            [
  ​             [
  ​              {
  ​               "x" : 366,
  ​               "y" : 660
  ​              },
  ​              {
  ​               "x" : 588,
  ​               "y" : 648
  ​              },
  ​              {
  ​               "x" : 480,
  ​               "y" : 818
  ​              },
  ​              {
  ​               "x" : 396,
  ​               "y" : 911
  ​              },
  ​              {
  ​               "x" : 573,
  ​               "y" : 901
  ​              }
  ​             ]
  ​            ]
  ​      },
  ​      "result" : "ok"
  ​     }
    }
  • 返回参数说明
**参数名****类型****说明**
messageYstring返回描述
statusYintcode 状态码
dataYobject返回 JSON 对象
+resultYstring算法层执行结果
+FaceInfosYobject人脸关键点对象
++boxsYobject人脸位置信息数组
+++xYint人脸框 x 坐标
+++yYint人脸框 y 坐标
+++widthYint人脸框宽度
+++heightYint人脸框高度
++key_pointsYobject人脸五点信息数组
+++xYint头脸关键点 x 坐标
+++yYint头脸关键点 y 坐标

用户反馈接口

  • 接口说明

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

    • 调用 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
      }
      

文档中心