人脸识别    本接口免费使用   支持HTTPS   

  • 数据编号:
    16
  • 接口状态:
    正常
  • 数据类型:
    充值认证
  • 连接App数:
    2033
  • 描述:

    检测图片(Image)中的人脸(Face)的位置和相应的人脸属性,目前支持单张人脸检测。目前人脸属性包括性别(gender), 年龄(age)和姿势(pose)。检测有效后会由系统生成唯一的face_id, 若face_id没有被加入任何people之中,则在48小时之后过期被自动清除。

接口地址:http://api.avatardata.cn/Face/CheckOne
返回格式:JSON/XML
请求方式:GET/POST
请求示例: http://api.avatardata.cn/Face/CheckOne?key=[您申请的APPKEY]&imgUrl=http://f.hiphotos.baidu.com/image/pic/item/d31b0ef41bd5ad6ec8a8eee783cb39dbb6fd3c6d.jpg
接口备注:
请求参数:
  名称 类型 必填 说明
  key String 应用APPKEY
  imgUrl String 图片UR(图片URL、图片转base64字符串、图片内容byte数组三个参数任选其一赋值,另两个赋值为空即可)
  bas64String String 图片转base64字符串(图片URL、图片转base64字符串、图片内容byte数组三个参数任选其一赋值,另两个赋值为空即可)
  fileContent String 图片内容byte数组(图片URL、图片转base64字符串、图片内容byte数组三个参数任选其一赋值,另两个赋值为空即可)
  dtype String 返回结果格式:可选JSON/XML,默认为JSON
  format Boolean 当返回结果格式为JSON时,是否对其进行格式化,为了节省流量默认为false,测试时您可以传入true来熟悉返回内容
  名称 类型 说明
  请参考JSON返回示例 - -
JSON返回示例:

{

  "error_code": 0,/*返回状态值*/

  "reason": "Succes",/*返回状态描述*/

  "result": /*返回数据对象*/

  {

    "face": [/*被检测出的人脸,当前版本支持单张人脸信息返回*/

      {

        "attribute": {/*属性*/

          "age": 24,/*年龄,表示估计的年龄*/

          "gender": "Female",/*性别,值为Male/Female*/

          "becovered": null,

          "pose": {/*脸部姿势分析结果,歪头tilting,抬低头raise,摇头turn。每个值为[-90,90]近似角度值;平面内左右歪头:正左、负右;扭头:正左、负右;低抬头:正抬、负低;*/

            "tilting": 4,/*歪头角度*/

            "raise": -5,/*抬低头角度*/

            "turn": 28/*摇头角度*/

          }

        },

        "face_id": "b747e85308aa487891038055e290dba5",/*被检测出的每一张人脸都在EyeKey系统中的标识符*/

        "lefteye_opendegree": null,/*检出人脸左眼的睁开程度(0~100之间的整数)*/

        "righteye_opendegree": null,/*检出人脸右眼的睁开程度(0~100之间的整数)*/

        "mouth_opendegree": null,/*检出人脸的嘴巴张开程度(0~100之间的整数)*/

        "position": {/*人脸标记关键点的属性*/

          "center": {/*检出的人脸框的中心点坐标, x & y 坐标分别表示在图片中的宽度和高度*/

            "x": 204.0,

            "y": 246.0

          },

          "eye_left": {/*相应人脸的左眼坐标,x & y 坐标分别表示在图片中的宽度和高度*/

            "x": 308.0,

            "y": 362.0

          },

          "eye_right": {/*相应人脸的右眼坐标,x & y 坐标分别表示在图片中的宽度和高度*/

            "x": 476.0,

            "y": 359.0

          },

          "height": 371.0,/*实数,表示检出的脸的高度*/

          "width": 371.0,/*实数,表示检出的脸的宽度*/

          "mouth_left": null,/*左嘴角坐标*/

          "mouth_right": null,/*右嘴角坐标*/

          "nose": null/*鼻子坐标*/

        },

      }

    ],

    "img_height": "1000",/*返回数据对象*/

    "img_id": "020-9353c8ec8d18bda1",/*返回数据对象*/

    "img_width": "692",/*返回数据对象*/

    "url": "http://f.hiphotos.baidu.com/image/pic/item/d31b0ef41bd5ad6ec8a8eee783cb39dbb6fd3c6d.jpg"/*人脸识别云服务端图片地址*/

  }

}