人脸对比
更新时间: 2025/03/05 16:07:31接口说明
用于比对两张图片中人脸的相似度,并返回相似度分值。如果图中存在多张人脸,只会选择最大的那张进行对比。
接口URL
https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/match
请求方式:POST
请求参数
Header
| 名称 | 参数值 | 是否必传 | 说明 |
|---|---|---|---|
| Content-Type | multipart/form-data | 是 | 请求头 |
Body
接口参数
| 参数名称 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| ImageA | File | 是 | 人脸图片,人脸必须是正面无遮挡人脸,大小不可超过5M,分辨率小于4000*2000,支持 PNG、JPG、JPEG 格式; |
| ImageB | File | 是 | 人脸图片,人脸必须是正面无遮挡人脸,大小不可超过5M,分辨率小于4000*2000,支持 PNG、JPG、JPEG 格式; |
返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| RspCode | Integer | 错误码 |
| RspDesc | String | 描述 |
| Data | Map | 数据集合 |
Data参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| Score | Double | 人脸相似度得分,范围【0~100】,推荐阈值70分 |
示例
请求示例
curl -X POST https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/user/match \
-H "Content-Type: multipart/form-data" \
-F "RequestId=2d95a5fe-a384-5dea-0d84-db153b10ee0f" \
-F "AppId=demo" \
-F "CompID=1" \
-F "SecretKey=a7febff6a21c36fb50150f88c95ef641" \
-F "ImageA=@face_1.jpg" \
-F "ImageB=@face_2.jpg"
返回示例
{
"RspCode":0,
"RspDesc":"请求成功",
"Data":{
"Score": 96.5
}
}
错误码
上述接口在 Body 中返回请求的错误码,详情请参见 错误码