Skip to content

人脸检测


接口描述

在图片中准确地标出人脸位置,对不同角度、光照、表情、遮挡、年龄的人脸都有较好的适应性。

  • 单人脸检测:返回图片中单人脸位置和大小;
  • 多人脸检测:图片中存在多个人脸时,返回所有人脸的位置和大小。

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/face/tool/detect

Header如下:

参数名称
Content-Typeapplication/json;charset=UTF-8

Body中放置请求参数,参数详情如下:

请求参数:

参数名称必填数据类型长度参数描述
imgString1-3000k待处理图片(base64 编码),原始图片大小需要小于 3M;
modeBoolean1可选,是否返回每张人脸图片true表示返回,false表示不返回
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "img": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
    "mode": true
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeint1-8返回结果,0表示成功
messageString1-255返回码描述
dataObject-返回的数据
-busFlowIdString1-64业务流水号,业务系统唯一序列号
-flowIdString1-64交易流水ID(建议保存)
-facesObject-返回检测到的人脸数据
--xint4人脸x坐标
--yint4人脸y坐标
--widthint4人脸宽度
--heightint4人脸高度
--imgString1-300kBase64编码的人脸图片数据,如果mode=false 则为”null”

返回示例:

{
    "code": 0,
    "data": {
        "faces": [
            {
                "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
                "x": 167,
                "width": 171,
                "y": 227,
                "height": 171
            }
        ]
    },
    "success": true,
    "message": "success"
}

是否仍需要帮助? 请保持联络!