简介
本文档提供关于图像检索的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
可通过输入自然语言或图片，基于语义对数据集内文件进行图像检索。 |
SDK API 参考
图像检索
功能说明
可通过输入自然语言或图片，基于语义对数据集内文件进行图像检索。
注意：
COS iOS SDK 版本需要大于等于 v6.4.1。
示例代码
Objective-C
QCloudSearchImageRequest * request = [QCloudSearchImageRequest new];request.regionName = @"COS_REGIONNAME";request.input = [QCloudSearchImage new];// 数据集名称，同一个账户下唯一。;是否必传：是request.input.DatasetName = @"ImageSearch001";// 指定检索方式为图片或文本，pic 为图片检索，text 为文本检索，默认为 pic。;是否必传：否request.input.Mode = @"pic";// 资源标识字段，表示需要建立索引的文件地址(Mode 为 pic 时必选)。;是否必传：否request.input.URI = @"cos://facesearch-1258726280/huge_base.jpg";// 返回相关图片的数量，默认值为10，最大值为100。;是否必传：否request.input.Limit = 10;// 出参 Score（相关图片匹配得分） 中，只有超过 MatchThreshold 值的结果才会返回。默认值为0，推荐值为80。;是否必传：否request.input.MatchThreshold = 1;[request setFinishBlock:^(QCloudSearchImageResponse * outputObject, NSError *error) {// result：QCloudSearchImageResponse 包含所有的响应；// 具体查看代码注释或api文档：https://cloud.tencent.com/document/product/460/106376}];[[QCloudCOSXMLService defaultCOSXML] SearchImage:request];
说明：
Swift
let request : QCloudSearchImageRequest = QCloudSearchImageRequest();request.regionName = "COS_REGIONNAME";request.input = QCloudSearchImage();// 数据集名称，同一个账户下唯一。;是否必传：是request.input.datasetName = "ImageSearch001";// 指定检索方式为图片或文本，pic 为图片检索，text 为文本检索，默认为 pic。;是否必传：否request.input.mode = "pic";// 资源标识字段，表示需要建立索引的文件地址(Mode 为 pic 时必选)。;是否必传：否request.input.uri = "cos://facesearch-1258726280/huge_base.jpg";// 返回相关图片的数量，默认值为10，最大值为100。;是否必传：否request.input.limit = 10;// 出参 Score（相关图片匹配得分） 中，只有超过 MatchThreshold 值的结果才会返回。默认值为0，推荐值为80。;是否必传：否request.input.matchThreshold = 1;request.finishBlock = { result, error in// result：QCloudSearchImageResponse 包含所有的响应；// 具体查看代码注释或api文档：https://cloud.tencent.com/document/product/460/106376};QCloudCOSXMLService.defaultCOSXML().searchImage(request);
说明：
