人脸检测
更新时间: 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 中返回请求的错误码,详情请参见 错误码