简介
本文档提供关于人脸检索的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。 |
SDK API 参考
人脸检索
功能说明
从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。
注意:
COS iOS SDK 版本需要大于等于 v6.4.1。
示例代码
Objective-C
QCloudDatasetFaceSearchRequest * request = [QCloudDatasetFaceSearchRequest new];request.regionName = @"COS_REGIONNAME";request.input = [QCloudDatasetFaceSearch new];// 数据集名称,同一个账户下唯一。;是否必传:是request.input.DatasetName = @"test";// 资源标识字段,表示需要建立索引的文件地址。;是否必传:是request.input.URI = @"cos://examplebucket-1250000000/test.jpg";// 输入图片中检索的人脸数量,默认值为1(传0或不传采用默认值),最大值为10。;是否必传:否request.input.MaxFaceNum = 1;// 检索的每张人脸返回相关人脸数量,默认值为10,最大值为100。;是否必传:否request.input.Limit = 10;// 限制返回人脸的最低相关度分数,只有超过 MatchThreshold 值的人脸才会返回。默认值为0,推荐值为80。 例如:设置 MatchThreshold 的值为80,则检索结果中仅会返回相关度分数大于等于80分的人脸。;是否必传:否request.input.MatchThreshold = 10;[request setFinishBlock:^(QCloudDatasetFaceSearchResponse * outputObject, NSError *error) {// result:QCloudDatasetFaceSearchResponse 包含所有的响应;// 具体查看代码注释或api文档:https://cloud.tencent.com/document/product/460/106166}];[[QCloudCOSXMLService defaultCOSXML] DatasetFaceSearch:request];
说明:
Swift
let request : QCloudDatasetFaceSearchRequest = QCloudDatasetFaceSearchRequest();request.regionName = "COS_REGIONNAME";request.input = QCloudDatasetFaceSearch();// 数据集名称,同一个账户下唯一。;是否必传:是request.input.datasetName = "test";// 资源标识字段,表示需要建立索引的文件地址。;是否必传:是request.input.uri = "cos://examplebucket-1250000000/test.jpg";// 输入图片中检索的人脸数量,默认值为1(传0或不传采用默认值),最大值为10。;是否必传:否request.input.maxFaceNum = 1;// 检索的每张人脸返回相关人脸数量,默认值为10,最大值为100。;是否必传:否request.input.limit = 10;// 限制返回人脸的最低相关度分数,只有超过 MatchThreshold 值的人脸才会返回。默认值为0,推荐值为80。 例如:设置 MatchThreshold 的值为80,则检索结果中仅会返回相关度分数大于等于80分的人脸。;是否必传:否request.input.matchThreshold = 10;request.finishBlock = { result, error in// result:QCloudDatasetFaceSearchResponse 包含所有的响应;// 具体查看代码注释或api文档:https://cloud.tencent.com/document/product/460/106166};QCloudCOSXMLService.defaultCOSXML().datasetFaceSearch(request);
说明: