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)
