图像检索

最近更新时间:2024-07-03 15:37:12

我的收藏

功能描述

支持输入自然语言文本或者图片,在指定数据集中检索出符合输入的文本语义或图片内容相似的图片。

费用说明

有关图像检索的费用,请参见 智能检索费用

授权说明

授权策略中 action 设置为 ci:DatasetImageSearch,详情请参见 数据万象 action

限制说明

返回相关图片数量最大为100。

请求

请求示例

POST /datasetquery/imagesearch HTTP/1.1
Host: <AppId>.ci.<Region>.myqcloud.com
Authorization: Auth String
Content-Length: xxx
Content-Type: application/json
Accept: application/json
说明:
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

{
"DatasetName": "ImageSearch001",
"Mode": "pic",
"URI": "cos://facesearch-1258726280/huge_base.jpg",
"Limit": 10,
"MatchThreshold": 1
}

请求参数

参数名称
描述
类型
是否必选
DatasetName
数据集名称,同一个账户下唯一。
String
Mode
指定检索的输入类型,有效值为:
pic:表示输入图片进行以图搜图的检索。
text:表示输入文本进行检索,支持输入自然语言,例如“包含一颗大树的图片”。
默认值为 pic。
String
URI
资源标识字段,表示需要建立索引的文件地址(Mode 为 pic 时必选)。
String
Limit
返回相关图片的数量,默认值为10,最大值为100。
Integer
Text
检索语句,检索方式为 text 时必填,最多支持60个字符 (Mode 为 text 时必选)。
示例:包含一颗大树的图片
String
MatchThreshold
限制返回图片的最低相关度分数,只有超过 MatchThreshold 值的图片才会返回。默认值为0,推荐值为80。
例如:设置 MatchThreshold 的值为80,则检索结果中仅会返回相关度分数大于等于80分的图片。
Integer

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

{
"ImageResult": [{
"URI": "cos://facesearch-1258726280/huge_base.jpg",
"Score": 99
}],
"RequestId": "NjYwYzEwYjhfNGQ2ODk0MGJfMjcwNl82"
}
响应包体具体数据内容如下:
参数名称
类型
描述
ImageResult
Container Array
图像检索识别结果信息列表。
RequestId
String
请求 ID。
ImageResult 节点内容:
参数名称
类型
描述
URI
String
资源标识字段,表示需要建立索引的文件地址。
Score
Integer
图片相关度分数,分数越高表示与检索条件越相符。