人脸识别

人脸对比

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