批量添加人脸数据 功能描述批量添加人脸数据能力可以为已创建好的人脸样本中批量添加人脸数据，每个人脸样本最多可以添加5张人脸照片，所以批量添加最多一次添加5张人脸照片。输入限制图像格式：JPG、JPEG、PNG、BMP。图像大小：不超过5 MB。图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。URL地址中不能包含中文字符。请求参数名称类型是否必选示例值描述ActionString是BatchAddFaces系统规定参数，取值为BatchAddFacesDbNameString是default数据库名称，支持小写字母、数字、下划线组合，长度1 - 64EntityIdString是U1实体ID，用于标识用户唯一性，每个实体可包含多张人脸图片，支持大小写字母、数字、下划线、减号组合，长度2 - 64字符SimilarityScoreThresholdInEntityFloat否50.0类内相似度阈值，将新增人脸图片与EntityId内已有人脸进行相似度比对，小于该阈值则添加失败；若EntityId内没有人脸存在，则添加成功。取值范围[0.0, 100.0]，0.0或空表示不做类内相似度判断逻辑SimilarityScoreThresholdBetweenEntityFloat否50.0类间相似度阈值，将新增人脸图片与其他所有EntityId内已有人脸进行相似度比对，大于等于该阈值则表示其他EntityId内存在相似人脸，出现重复，添加失败。取值范围[0.0, 100.0]，0.0或空表示不做类间相似度判断逻辑FacesArray是-人脸信息ExtraDataString否王小二自定义信息，支持字母、数字、标点符号和汉字，不超过512个字符ImageUrlString是https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/1.png人脸图像URL地址，人脸必须是正面无遮挡单人脸，推荐使用上海地域的OSS链接QualityScoreThresholdFloat否50.0质量分阈值，对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围[0.0, 100.0]，0.0或空则表示不做质量分判断逻辑返回数据名称类型示例值描述RequestIdStringC46A46D0-3263-181A-A1EE-0901E4595390请求IDDataObject-返回的结果数据内容InsertedFacesArray of InsertedFaces-添加成功的记录结果ImageUrlStringhttps://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/xxxx.png人脸图像地址，与输入的ImageUrl相同，用来标记图像记录FaceIdString16350536输出人脸IDQualityScoreFloat99.79581输入图像中的人脸质量分FailedFacesArray of failedFaces-添加失败的记录结果ImageUrlStringhttps://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/xxxx.png人脸图像地址，与输入的ImageUrl相同，用来标记图像记录CodeStringClientError.IllegalArgument错误码MessageStringnot 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" } ] } }

添加人脸数据 功能描述添加人脸数据能力可以为指定数据库添加人脸数据，单个人脸数据库支持最多5万张人脸照片入库，人脸数据是在已创建好的人脸样本中添加，每个人脸样本最多可以添加5张人脸照片。人脸照片入库量以及每个人脸样本最多添加的照片量暂不支持扩容。输入限制图像格式：JPG、JPEG、PNG。图像大小：不超过5 MB。图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。URL地址中不能包含中文字符。图片中若包含多个人脸，会取最大的人脸进行添加。请求参数名称类型是否必选示例值描述ActionString是AddFace系统规定参数，取值为AddFaceDbNameString是default数据库名称，支持小写字母、数字、下划线的组合，长度1 - 64ImageUrlString是https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imsearch/demo/1.png人脸图片地址，人脸须为正面无遮挡人脸（若包含多张人脸则取最大人脸添加），推荐使用上海地域OSS链接EntityIdString是U1实体ID，用于标识用户唯一性，每个实体可包含多张人脸图片，支持大小写字母、数字、下划线、减号组合，长度1 - 64字符ExtraDataString否王小二自定义信息，支持字母、数字、标点符号和汉字，不超过512个字符QualityScoreThresholdFloat否50.0质量分阈值，对新增人脸图片进行质量分析，质量分小于该阈值则添加失败，取值范围[0.0,100.0]，0.0或空表示不做质量判断SimilarityScoreThresholdInEntityFloat否50.0类内相似度阈值，将新增人脸图片与EntityId内已有人脸进行相似度比对，小于该阈值则添加失败，取值范围[0.0,100.0]，0.0或空表示不做类内相似度判断SimilarityScoreThresholdBetweenEntityFloat否50.0类间相似度阈值，将新增人脸图片与其他所有EntityId内已有人脸进行相似度比对，大于等于该阈值则添加失败，取值范围[0.0,100.0]，0.0或空表示不做类间相似度判断返回数据名称类型示例值描述RequestIdString2B93C43A-F824-40C8-AF79-844342B0F43A请求IDDataObject-返回的结果数据内容FaceIdString5输出人脸IDQualityScoreFloat99.79581输入图像中的人脸质量分HTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "2B93C43A-F824-40C8-AF79-844342B0F43A", "Data" : { "FaceId" : "5", "QualitieScore" : 99.79581 } }

更新人脸样本 功能描述更新人脸样本能力用于更新人脸数据库中的人脸样本数据。请求参数名称类型是否必选示例值描述DbNameString是default数据库名称EntityIdString是mm2实体ID，如用户ID、员工ID等LabelsString否鹿班标签名称，最多可以添加10个标签返回数据名称类型示例值描述RequestIdStringDA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2请求IDHTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2" }

查询人脸样本列表 功能描述查询人脸样本列表能力用于查询人脸数据库中的人脸样本列表。这两张图片展示了列出人脸实体接口的请求参数和返回数据结构。请求参数名称类型是否必选示例值描述DbNameString是default数据库名称OffsetInteger否1起始记录，取值范围0~2000LimitInteger否50每页最多显示的样本数目，取值范围1~200TokenString否2当查询结果超过2000条时，需用上一次请求返回的Token作为请求下一页的参数LabelsString否鹿班标签，最多支持10个，多个标签以英文逗号分割EntityIdPrefixString否U1样本ID前缀，包含数字、字母和下划线OrderString否asc排列方式，包括asc（升序）和desc（降序）返回数据名称类型示例值描述RequestIdStringDA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2请求IDDataObject-返回的结果数据内容TokenString2当查询结果超过2000条时，可使用Token查询下一页数据TotalCountInteger200人脸样本的总数量EntitiesArray of Entity-查询到的实体数据DbNameStringdefault人脸样本所在的数据库名称EntityIdString222实体ID，如员工编号LabelsString鹿班查询到的人脸数据标签CreatedAtLong1589203871832人脸样本的创建时间FaceCountInteger3人脸样本包含的人脸数量UpdatedAtLong1589203871832人脸样本的更新时间HTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2", "Data" : { "Token" : "2", "TotalCount" : "200", "Entities" : [ { "DbName" : "default", "EntityId" : "222", "FaceCount" : "3", "Labels" : "鹿班", "CreatedAt" : "1589203871832", "UpdatedAt" : "1589203871832" } ] } }

查询人脸样本 功能描述查询人脸样本能力用于查询人脸数据库中的人脸样本数据。请求参数名称类型是否必选示例值描述DbNameString是default数据库名称EntityIdString是66实体ID，可以包含数字、字母和下划线返回数据名称类型示例值描述RequestIdStringDA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2请求IDDataObject-返回的结果数据内容DbNameStringdefault数据库名称EntityIdString66实体IDLabelsString工厂查询到的人脸标签FacesArray of Face-查询到的人脸数据FaceIdString3人脸数据IDHTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2", "Data" : { "DbName" : "default", "EntityId" : "66", "Labels" : "工厂", "Faces" : [ { "FaceId" : "3" } ] } }

添加人脸样本 功能描述添加人脸样本能力用于向人脸数据库中添加人脸样本数据。人脸样本数据是用来标识用户的唯一性，如用户ID、员工ID等。限制说明每个人脸数据库支持最高5万人脸特征，暂不支持扩容。人脸样本和标签组合为一个人脸特征。每个人脸样本支持添加最多10个标签数据，暂不支持扩容。添加人脸样本接口提交任务并发默认为2QPS。请求参数名称类型是否必选示例值描述DbNameString是default数据库名称EntityIdString是mm2实体ID，可以包含数字、字母和下划线LabelsString否鹿班输入标签，最多可添加10个标签，标签仅支持下划线和连字符，标签间用英文逗号分隔返回数据名称类型示例值描述RequestIdStringDA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2请求IDHTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2" }

查询人脸数据库列表 功能描述本能力用于查询人脸数据库列表。人脸数据库最多只能返回200条记录。请求参数名称类型是否必选示例值描述OffsetLong否1默认起始页从0开始，不填写默认从0页开始返回数据LimitLong否50每页最多显示的样本数目，范围1~200，默认200返回数据名称类型示例值描述RequestIdString2B93C43A-F824-40C8-AF79-844342B0F43A请求IDDataObject-返回的数据内容DbListArray of DbList-数据库列表NameStringdefault数据库名称HTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "2B93C43A-F824-40C8-AF79-844342B0F43A", "Data" : { "DbList" : [ { "Name" : "default" } ] } }

创建人脸数据库 功能描述创建人脸数据库能力可以创建人脸数据库用来存放人脸数据。每个阿里云账号可以创建10个人脸数据库，10个人脸数据库支持最多50万张人脸照片的入库，单个人脸数据库支持最多5万张人脸照片入库，单次搜索可支持最多10个人脸数据库的同时搜索（跨库搜索）。人脸数据库、人脸照片入库量、单次搜索的人脸总数以及单次搜索的人脸数据库暂不支持扩容。请求参数名称类型是否必选示例值描述NameString是default数据库名称，支持字母、数字和下划线组合，长度为 1 - 64返回数据名称类型示例值描述RequestIdString818D24A6-E368-46B3-99C5-3CF36D98CCA3请求 IDHTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "818D24A6-E368-46B3-99C5-3CF36D98CCA3" }

人脸搜索 功能描述人脸搜索能力可以根据输入图片，在数据库中搜索并返回相似的人脸图片数据。单次搜索最多可支持10个人脸数据库的同时搜索（跨库搜索）。该能力根据人脸特征来进行识别，通过把人脸图像特征化，然后比较人脸特征的相似程度。前提条件：已通过创建人脸数据库（CreateFaceDb）接口创建了数据库名称（DbName）。已通过添加人脸样本（AddFaceEntity）接口创建了实体ID（EntityId）。已通过添加人脸数据（AddFace）接口给数据库（DbName）下的实体ID（EntityId）添加了人脸图片。输入限制图像格式：JPG、JPEG、PNG。图像大小：不超过5 MB。图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。URL地址中不能包含中文字符。支持图片中包含最多10个人脸，超过部分会被忽略。请求参数SearchFaceAdvanceRequest名称类型是否必选示例值描述db_nameString否default数据库名称。image_url_objectString是 图像二进制数据。limitInteger是2单个人脸列表中搜索人脸结果数量限制，取值范围 1~100。db_namesString否test1,test2,test3数据库名称列表，以英文逗号 (,) 分割，可以实现跨库查询，最大支持 10 个数据库。quality_score_thresholdFloat否50.0质量分阈值。对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围[0.0,100.0]。0.0 或空则表示不做质量分判断逻辑。max_face_numLong否5对输入图像中多少个人脸进行检索比对，控制人脸样本列表个数，取值范围 1~10，默认为 5。{alert type="info"}说明：db_name 与 db_names 二选一，如果同时配置了两个参数，db_names 优先级高于 db_name。{/alert}返回数据名称类型示例值描述RequestIdString4159ee4a-0fe8-438c-a8de-ee531555b3c请求 ID。DataObject-返回的结果数据内容。MatchListArray of MatchList-匹配的结果列表，如果输入图像中多个人脸，则这里会返回多个数据。FaceItemsArray of FaceItems-匹配的人脸数据列表。EntityIdStringU1实体 ID，用来标识用户的唯一性，如用户 ID、员工 ID 等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线和减号的组合，长度为 2~64。FaceIdString001人脸图片数据 ID，需要全局唯一，不可重复。支持小写字母、数字和下划线的组合。长度为 1~64。ScoreFloat0.892133人脸的相似度，取值范围-1.0~1.0，取小数点后 6 位，数值越大相似度越高，建议的三个参考阈值为 0.35，0.45 和 0.6，分别对应千分之一，万分之一和十万分之一的误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。ExtraDataString王小二自定义信息（字符串）。支持字母、数字、标点符号和汉字。不超过 512 个字符。DbNameStringdefault数据库名称。ConfidenceFloat36.820168转换后的置信度，取值范围 0.0~100.0，数值越大相似度越高，建议的三个参考阈值为 60.48，67.87 和 72.62，分别对应千分之一，万分之一和十万分之一的误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。LocationObject-输入图像中的人脸坐标信息。WidthInteger200宽度，单位像素。HeightInteger200高度，单位像素。YInteger6左上角 y 坐标。XInteger5左上角 x 坐标。QualityScoreFloat71.7349输入图像中的人脸质量分。HTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "4159e64a-0fe8-436c-a8de-ee531555db3c", "Data" : { "MatchList" : [ { "FaceItems" : [ { "EntityId" : "U1", "FaceId" : "001", "Score" : 0.892133, "ExtraData" : "王小二", "DbName" : "default", "Confidence" : 36.820168 } ], "Location" : { "Width" : 200, "Height" : 200, "Y" : 6, "X" : 5 }, "QualitieScore" : 71.7349 } ] } } def search_face_advanced(self, db_name, limit=5, local_image_path=None, image_url=None): """ 人脸搜索 :param db_name: 数据库名称 :param limit: 返回结果的数量限制 :param local_image_path: 本地图片文件路径 :param image_url: 网络图片的 URL :return: 响应结果或异常信息 """ try: if local_image_path: if not os.path.exists(local_image_path): raise FileNotFoundError(f"文件 {local_image_path} 不存在。") with open(local_image_path, 'rb') as stream: image_data = stream.read() image_obj = io.BytesIO(image_data) elif image_url: img = urlopen(image_url).read() image_obj = io.BytesIO(img) else: raise ValueError("请提供本地图片路径或网络图片 URL") request = SearchFaceAdvanceRequest( db_name=db_name, limit=limit, image_url_object=image_obj ) response = self.client.search_face_advance(request, self.runtime_option) return response.body except Exception as error: print(error) if hasattr(error, 'code'): print(error.code) return error

时政目录 1. 【1月时政】2. 【2月时政】3. 【3月时政】4. 【4月时政】5. 【5月时政】6. 【6月时政】7. 【7月时政】8. 【8月时政】9. 【9月时政】