功能描述
批量添加人脸数据能力可以为已创建好的人脸样本中批量添加人脸数据，每个人脸样本最多可以添加5张人脸照片，所以批量添加最多一次添加5张人脸照片。
输入限制
图像格式：JPG、JPEG、PNG、BMP。
图像大小：不超过5 MB。
图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。
URL地址中不能包含中文字符。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | BatchAddFaces | 系统规定参数，取值为BatchAddFaces |
| DbName | String | 是 | default | 数据库名称，支持小写字母、数字、下划线组合，长度1 - 64 |
| EntityId | String | 是 | U1 | 实体ID，用于标识用户唯一性，每个实体可包含多张人脸图片，支持大小写字母、数字、下划线、减号组合，长度2 - 64字符 |
| SimilarityScoreThresholdInEntity | Float | 否 | 50.0 | 类内相似度阈值，将新增人脸图片与EntityId内已有人脸进行相似度比对，小于该阈值则添加失败；若EntityId内没有人脸存在，则添加成功。取值范围[0.0, 100.0]，0.0或空表示不做类内相似度判断逻辑 |
| SimilarityScoreThresholdBetweenEntity | Float | 否 | 50.0 | 类间相似度阈值，将新增人脸图片与其他所有EntityId内已有人脸进行相似度比对，大于等于该阈值则表示其他EntityId内存在相似人脸，出现重复，添加失败。取值范围[0.0, 100.0]，0.0或空表示不做类间相似度判断逻辑 |
| Faces | Array | 是 | - | 人脸信息 |
| ExtraData | String | 否 | 王小二 | 自定义信息，支持字母、数字、标点符号和汉字，不超过512个字符 |
| ImageUrl | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/1.png | 人脸图像URL地址，人脸必须是正面无遮挡单人脸，推荐使用上海地域的OSS链接 |
| QualityScoreThreshold | Float | 否 | 50.0 | 质量分阈值，对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围[0.0, 100.0]，0.0或空则表示不做质量分判断逻辑 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | C46A46D0-3263-181A-A1EE-0901E4595390 | 请求ID |
| Data | Object | - | 返回的结果数据内容 |
| InsertedFaces | Array of InsertedFaces | - | 添加成功的记录结果 |
| ImageUrl | String | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/xxxx.png | 人脸图像地址，与输入的ImageUrl相同，用来标记图像记录 |
| FaceId | String | 16350536 | 输出人脸ID |
| QualityScore | Float | 99.79581 | 输入图像中的人脸质量分 |
| FailedFaces | Array of failedFaces | - | 添加失败的记录结果 |
| ImageUrl | String | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/xxxx.png | 人脸图像地址，与输入的ImageUrl相同，用来标记图像记录 |
| Code | String | ClientError.IllegalArgument | 错误码 |
| Message | String | not found the db=test | 错误信息 |
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C46A46D0-3263-181A-A1EE-0901E4595390",
"Data" : {
"InsertedFaces" : [ {
"ImageURL" : "https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png",
"FaceId" : "16350536",
"QualitieScore" : 99.79581
} ],
"FailedFaces" : [ {
"ImageURL" : "https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png",
"Code" : "ClientError.IllegalArgument",
"Message" : "not found the db=test"
} ]
}
}
评论 (0)