本文为您介绍初次使用图像搜索服务需要实施的准备工作及入门操作。
操作流程
步骤一:准备工作
登录账号
开通服务

选择调用方式
您可以根据自身需要,通过下列可选方式调用图像搜索服务:
通过 API 3.0 Explorer 进行在线调用图像搜索服务:如果您是开发初学者、有代码编写基础,对 HTTP 请求和 API 调用有一定的了解,您可以通过此方式使用图像搜索服务。该方式能够实现在线调用、签名验证、SDK 代码生成和快速检索接口等能力。
通过编写代码调用图像搜索服务 API :如果您是开发工程师,熟悉代码编写,您可以通过腾讯云已编写好的开发工具集(SDK)来调用图像搜索服务 API。SDK 已支持多种语言,包括 Python、Java、PHP、Go、NodeJS、.Net 等。您可以在每个服务的文档中下载对应的 SDK,也可以通过 SDK 中心 获取。
您也可以通过 腾讯云命令行工具 来调用腾讯云 API ,管理您的腾讯云资源;您还可以基于腾讯云 CLI 来做自动化和脚本处理,从而简化一些具有复杂 API 的服务。
步骤二:图片入库
准备自有图库
使用图像搜索产品时,需要您自主准备用于匹配的图片库,并明确图片库内每一张图片相匹配的 EntityId 、 PicName 。
EntityId :一个 EntityId 可以包含多张图片,最大支持10张图。
PicName : PicName 唯一确定一张图片,具有唯一性。
请您妥善保管您自主准备的图片库以及每一张图片相匹配的 EntityId 、 PicName 信息,这将是您进行检索图片、更新图片等操作的必要依据。
说明:
图像搜索产品在提供服务时,并不会直接储存您用于上传建库的图片,而是通过模型算法将其转化为包含图像特征的向量进行储存。
同样的,在进行图片检索时,您用于检索的图片也会被转化为向量用于匹配,以保证匹配查询的效率性。
图片检索结果返还时,为保障服务的隐私性及效率性,不会返还匹配到的图片本身,而是会返回其 EntityId 、PicName 及匹配分数。您在获得检索结果后,还需要在您自主准备的图片库里面进行 EntityId 、PicName 的查询,才能直观地看到匹配到的图片。
创建图片库
您可以选择以下两种方式创建图片库,用于后续在图像搜索产品中上传您将用于匹配的图片。
方式一:控制台创建
图片库 ID:填写图片库 ID,不可重复,仅支持字母、数字和下划线。
图片库最大容量:如达到容量限制后继续创建图片将会报错。

方式二:API 接口创建
创建图片
步骤三:图片搜索
检索图片
完成图片入库后,您可以按照 检索图片接口指引 ,通过调用接口上传您需要检索的图片,模型将会返回指定图片库中与之相似的图片列表。模型的输出将包含:检索到的图片数量、检索到的图片信息(包含 EntityId 、 PicName )、匹配分数等信息。
说明:
您通过调用接口获得的检索结果中,检索到的图片信息不包含匹配到的图片本身,而是对应图片的 EntityId 、 PicName 等信息。
自有图库查询
根据模型输出的 EntityId 、 PicName 信息,您可以在自有图库中自主查找到对应的图片。
步骤四:查看调用
