操作指引

最近更新时间:2025-07-30 17:37:52

我的收藏
本文为您介绍初次使用图像搜索服务需要实施的准备工作及入门操作。
为方便您进行试用,在开通图像搜索服务后,我们将以免费资源包的形式,向您赠送免费额度(请参见 计费概述)。您可以准备好测试用例,按照本文指引进行简单的图片入库、图片搜索服务试用。

操作流程

操作步骤
说明
注册腾讯云账号并开通相关服务
准备自有图库,创建在线图片库并上传图片
在线图片搜索,根据结果在自有图库中查找对应图片
查看服务调用情况及计费统计
说明:
操作流程仅展示了进行图像搜索服务试用所需要的基础操作步骤。
在具体的业务场景中,图像搜索服务为您提供了更新图片、删除图片等操作接口以匹配多样化需求,具体调用方式请参见 API 文档

步骤一:准备工作

登录账号

注册并通过实名认证后,您可以登录腾讯云 控制台 进行使用。如果没有账号,请参见 注册腾讯云教程

开通服务

登录腾讯云 控制台 后,勾选相关协议,单击立即开通,即可获得接口调用权限。


选择调用方式

您可以根据自身需要,通过下列可选方式调用图像搜索服务:
通过 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 等信息。

自有图库查询

根据模型输出的 EntityId 、 PicName 信息,您可以在自有图库中自主查找到对应的图片。

步骤四:查看调用

您可以登录腾讯云 图像搜索控制台 ,查看各服务的调用情况。

您可以通过查看 计费概述 了解图像搜索的计费与结算方式。