人脸识别

人脸检测

更新时间: 2025/03/05 16:07:31

接口说明

检测图片中的人脸并标记出位置信息。

接口URL

https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/detect

请求方式:POST

请求参数

Header

名称 参数值 是否必传 说明
Content-Type multipart/form-data 是 请求头

Body

公共参数

接口参数

参数名称 类型 是否必传 说明
Image File 是 人脸图片,人脸必须是正面无遮挡人脸,大小不可超过5M,分辨率小于4000*2000,支持 PNG、JPG、JPEG 格式;

返回参数

名称 类型 说明
RspCode Integer 错误码
RspDesc String 描述
Data Map 数据集合

Data参数说明:

名称 类型 说明
FaceCount Integer 检测到的图片中的人脸数量
FaceList List 人脸信息列表
- FaceProbability Double 人脸置信度,范围【0~1】,代表这是一张人脸的概率
- Location Object 人脸在图片中的位置
- - Left Double 人脸区域离左边界的距离
- - Top Double 人脸区域离上边界的距离
- - Width Double 人脸区域的宽度
- - Height Double 人脸区域的高度

示例

请求示例

curl -X POST https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/user/delete \
-H "Content-Type: multipart/form-data" \
-F "RequestId=2d95a5fe-a384-5dea-0d84-db153b10ee0f"  \
-F "AppId=demo"  \
-F "CompID=1"  \
-F "SecretKey=a7febff6a21c36fb50150f88c95ef641"  \
-F "Image=@face.jpg"

返回示例

{
    "RspCode":0,
    "RspDesc":"请求成功",
    "Data":{
        "FaceCount":1,
        "FaceList":[
            {
                "FaceProbability":1,
                "Location":{
                    "Left":1051.66,
                    "Top":850.38,
                    "Width":627,
                    "Height":605
                }
            }
        ]
    }
}

错误码

上述接口在 Body 中返回请求的错误码,详情请参见 错误码