def SearchFaces(self, request): """用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopN 人员,识别结果按照相似度从大到小排序。单次搜索的人员库人脸总数量不得超过 100 万张。 此接口需与[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)结合使用。 :param request: 调用SearchFaces所需参数的结构体。 :type request: :class:`tencentcloud.iai.v20180301.models.SearchFacesRequest` :rtype: :class:`tencentcloud.iai.v20180301.models.SearchFacesResponse` """ try: params = request._serialize() body = self.call("SearchFaces", params) response = json.loads(body) if "Error" not in response["Response"]: model = models.SearchFacesResponse() model._deserialize(response["Response"]) return model else: code = response["Response"]["Error"]["Code"] message = response["Response"]["Error"]["Message"] reqid = response["Response"]["RequestId"] raise TencentCloudSDKException(code, message, reqid) except Exception as e: if isinstance(e, TencentCloudSDKException): raise else: raise TencentCloudSDKException(e.message, e.message)
def SearchFaces(self, request): """用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,识别结果按照相似度从大到小排序。 支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。 单次搜索的人员库人脸总数量和人员库的算法模型版本(FaceModelVersion)相关。算法模型版本为2.0的人员库,单次搜索人员库人脸总数量不得超过 100 万张;算法模型版本为3.0的人员库,单次搜索人员库人脸总数量不得超过 300 万张。 与[人员搜索](https://cloud.tencent.com/document/product/867/38881)及[人员搜索按库返回](https://cloud.tencent.com/document/product/867/38880)接口不同的是,本接口将该人员(Person)下的每个人脸(Face)都作为单独个体进行验证,而人员搜索及人员搜索按库返回接口 会将该人员(Person)下的所有人脸(Face)进行融合特征处理,即若某个Person下有4张 Face,本接口会将4张 Face 的特征进行融合处理,生成对应这个 Person 的特征,使搜索更加准确。 本接口需与[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)结合使用。 > - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。 :param request: Request instance for SearchFaces. :type request: :class:`tencentcloud.iai.v20180301.models.SearchFacesRequest` :rtype: :class:`tencentcloud.iai.v20180301.models.SearchFacesResponse` """ try: params = request._serialize() headers = request.headers body = self.call("SearchFaces", params, headers=headers) response = json.loads(body) if "Error" not in response["Response"]: model = models.SearchFacesResponse() model._deserialize(response["Response"]) return model else: code = response["Response"]["Error"]["Code"] message = response["Response"]["Error"]["Message"] reqid = response["Response"]["RequestId"] raise TencentCloudSDKException(code, message, reqid) except Exception as e: if isinstance(e, TencentCloudSDKException): raise else: raise TencentCloudSDKException(e.message, e.message)