# 图像搜索 ImageSearch > 从图库中搜索相同或相似的图片 ## 服务公告 - [华为云图像搜索服务于2026年6月30日00:00（北京时间）停售通知](https://support.huaweicloud.com/bulletin-imagesearch/imagesearch_06_0001.md): 华为云计划于2026/06/30 00:00（北京时间）正式停售华为云所有区域的图像搜索服务。停售区域：华为云全站。服务正式停售后，图像搜索服务服务将无法新购，已购买的服务在订阅期内可继续获得产品技术支持，服务预计下线时间2026年12月30日。推荐您根据自己的业务情况使用华为云商店同类产品，详细介绍可查看云商店官网。如您有任何问题，可随 ## 产品介绍 - [什么是图像搜索](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0001.md): 图像搜索（Image Search，又称为多媒体搜索）基于深度学习与图像识别技术，是一套开箱即用的场景化搜索服务，支持图像等数据的管理和搜索，提供多种通用预置场景的搜索能力，并支持低成本、高敏捷的定制化服务，为用户提供安全、可靠、快速、准确的一键部署场景化内容搜索需求。图像搜索服务以开放API（Application Programmin - [通用搜索](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0003.md): 功能介绍通用图像搜索，旨在针对入库的图像数据提供通用场景下的相同或相似图像搜索能力，目前包括图像检索图像、关键词检索、文本检索图像。用户在开启相应的检索子能力后，可以分别使用图像、关键词和文本对入库的图像进行搜索。通用图像搜索，旨在针对入库的图像数据提供通用场景下的相同或相似图像搜索能力，目前包括图像检索图像、关键词检索、文本检索图像。用 - [商品搜索](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0010.md): 功能介绍通用商品图像搜索针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索。服装商品图像搜索针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。通用商品图像搜索针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索。针对入库的图像数据提供商品类目 - [公共说明](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0008.md): 数据类型数据类型，指用户需要搜索的主要数据类型，即用户创建服务实例用于搜索什么类型的数据。例如：IMAGE，表示用户需要搜索的为图像数据。数据类型，指用户需要搜索的主要数据类型，即用户创建服务实例用于搜索什么类型的数据。例如：IMAGE，表示用户需要搜索的为图像数据。服务模板服务模板，指用户搜索数据的基础业务流程，即用户需要在业务中按照什 - [图像类说明](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0009.md): 图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。搜索类型通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。IMAGE: 图像检索。KEYWORD: 关键词检索。TEXT: 文本检索。通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户 - [使用限制](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0004.md): 受技术、成本与交互多种因素制约，图像搜索服务存在一些使用限制。其中系统级限制，是针对服务整体的约束。除系统级限制外，各种服务子项还有独立的使用限制条件。服务区域仅支持“华为-北京四”。请求body使用标准json格式，且大小不超过12M。默认不保存用户的图像或视频等数据。实例数量：每个用户默认可创建5个服务实例。如需创建更多服务实例，请联 - [计费说明](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0016.md): 图像搜索服务的计费项包含索引存储数量和搜索查询次数。由于存在资源占用，单个服务实例的存储数量存在计费下限，不同存储规格的服务实例存储数量下限分别为各自存储规格的10%，且最低存储数量下限为10万，实际存储数量小于数量下限时按照数量下限计费，大于数量下限时按实际数量计费。实例支持多个搜索类型时，索引存储数量超过存储下限时，按索引存储数量 * - [与其他云服务的关系](https://support.huaweicloud.com/productdesc-imagesearch/imagesearch_01_0011.md): 统一身份认证（Identity and Access Management，简称IAM）服务，IAM为图像搜索提供了用户认证和鉴权功能。图像搜索服务支持从OBS上采用临时授权或者匿名公开授权的方式获取数据并进行处理。 ## 快速入门 - [图像搜索服务使用简介](https://support.huaweicloud.com/qs-imagesearch/imagesearch_04_0001.md): 图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过Python、Java等编程语言调用图像搜索服务API进行数据的入库和搜索，帮助用户构建托管式的场景化搜索服务，打造智能化业务系统，提升业务效率。服务开通使用前，请登录图像搜索服务控制台开通服务。服务开 - [调用API实现功能](https://support.huaweicloud.com/qs-imagesearch/imagesearch_04_0002.md): 本章节通过Postman软件，调用通用图像搜索服务实例的添加数据API，帮助您快速熟悉API的使用方法，具体流程如下：步骤一：开通服务步骤二：创建实例步骤三：配置环境步骤四：Token认证鉴权步骤五：调用服务步骤六：删除实例已注册华为账号，并完成实名认证，账号不能处于欠费或冻结状态。服务申请开通您可以按照以下步骤进行操作：登录华为云图像搜 - [调用SDK实现功能](https://support.huaweicloud.com/qs-imagesearch/imagesearch_04_0003.md): 图像搜索服务软件开发工具包（ImageSearch SDK）是对图像搜索服务提供的REST API进行的封装，以简化用户的开发工作。本章节以搜索数据接口为例，介绍如何使用ImageSearch Java SDK在本地开发，用户调用接口函数即可使用SDK功能。其他接口功能及支持的SDK可参考图像搜索SDK参考。已注册华为账号，并完成实名认证 ## API参考 - [概述](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0001.md): 图像搜索（ImageSearch，又称为多媒体搜索）是一套开箱即用的场景化搜索服务，支持图像等数据的管理和搜索，提供多种通用预置场景的搜索能力，并支持低成本、高敏捷的定制化服务。旨在满足用户的安全、可靠、快速、准确的一键部署场景化内容搜索需求。本服务以开放API（Application Programming Interface，应用程序 - [调用说明](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0031.md): 图像搜索提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。同时图像搜索还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 - [终端节点](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0032.md): 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 - [基本概念](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0034.md): 账号用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账 - [API概览](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0002.md): 图像搜索服务所提供的API为自研API。通过使用服务的自研API，您可以完整的使用如下所有功能。API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。请求样例中的Token值以实际申请服务时所获取的Token值为准。endpoint、projectId以实际申请的服务所在区域为准。 - [构造请求](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token接口说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987 。请求URI由如下部分组成。{URI - [认证鉴权](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0006.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证通用请求。当调用API网关Silvan接口时，需要采用Token认证方式，需要使用roles为op_service的token，各服务的管理账号一般都具有op_service权限。当调用API网关Silvan接口时，需要采用Token认证方式，需 - [返回结果](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0005.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。对应请求消息头，响应同样也有消息头，如“Content-type”。对于获取用户Token接口，返回如图 - [添加数据 V2-RunAddData](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0038.md): 添加数据到用户指定的服务实例中。服务实例需要用户在图像搜索服务管理控制台上创建。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v2/{project_id}/mms/{service_name}/data/add状态码： 200 - [搜索查询 V2-RunSearch](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0039.md): 从指定服务实例中进行搜索。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v2/{project_id}/mms/{service_name}/search状态码： 200状态码： 400搜索商品图像，使用图像BASE64编码状态 - [检查数据 V2-RunCheckData](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0040.md): 检查指定服务实例中的对应数据，支持指定ID检查和条件检查。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v2/{project_id}/mms/{service_name}/data/check状态码： 200状态码： 400状 - [更新数据 V2-RunUpdateData](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0041.md): 更新指定服务实例中的对应数据。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v2/{project_id}/mms/{service_name}/data/update状态码： 200状态码： 400更新数据状态码： 200成功 - [删除数据 V2-RunDeleteData](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0042.md): 删除指定服务实例中的对应数据，支持指定ID删除和条件删除。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v2/{project_id}/mms/{service_name}/data/delete状态码： 200状态码： 400 - [状态码](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0018.md): HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。具体的状态码参见表1所示。 - [错误码](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0043.md): 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。其中，error_code表示错误 - [获取项目ID和名称](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0035.md): 在调用接口的时候，部分请求中需要填入项目ID或项目名称，所以需要获取到项目ID和名称。有如下两种获取方式：从控制台获取项目ID调用API获取项目ID登录管理控制台。鼠标移动到右上角的用户名上，在下拉列表中选择我的凭证。在我的凭证页面，可以查看用户名、账号名，在项目列表中查看项目。查看项目ID多项目时，展开所属区域，从项目ID列获取子项目I - [获取账号名和账号ID](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0036.md): 在调用接口的时候，部分请求中需要填入账号名（domain name）和账号ID（domain_id）。获取步骤如下：注册并登录管理控制台。鼠标移动至用户名，在下拉列表中单击我的凭证。在API凭证页面的查看账号名和账号ID。查看账号ID在API凭证页面的查看账号名和账号ID。 ## SDK参考 - [图像搜索SDK简介](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0001.md): 图像搜索（Image Search）基于深度学习与图像识别技术，结合不同应用业务和行业场景，利用特征向量化与搜索能力，帮助您从指定图库中搜索相同或相似的图片。图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取图像搜索结果，帮助用 - [获取认证信息](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0002.md): 使用服务API需要进行认证，推荐用户使用AK/SK方式。步骤如下：登录华为云管理控制台。鼠标移动至用户名处，在下拉列表中单击“我的凭证”。选择“访问密钥”页签，单击“新增访问密钥”按钮。通过邮箱或者手机进行验证，输入对应的验证码。单击“确定”，下载认证账号的AK/SK，AK/SK数据会以本地文件的形式保存，请妥善保管。 - [准备环境](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0003.md): 在使用图像搜索SDK时，各语言需要准备的环境，参考表1。开发环境开发语言准备项说明JAVA安装JDKJAVA环境开发配置，支持 Java JDK 1.8 及其以上版本，推荐通过Maven 安装依赖的方式使用JAVA版本SDK。PYTHON安装pythonpython版本sdk支持python3.3及以上版本。.NET安装.NET.NET - [SDK代码示例自动生成](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0004.md): API Explorer提供API检索及平台调试，支持全量快速检索、可视化调试、帮助文档查看、在线咨询。您只需要在API Explorer中修改接口参数，即可自动生成对应的代码示例。同时，可在集成开发环境CloudIDE中完成代码的构建、调试、运行等操作。表1提供了各个云服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获 - [JAVA开发环境配置](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0006.md): SDK包要求JDK版本必须高于JDK8，如下操作以win7环境配置JDK8 64位为例，若已经下载JDK并配置好环境请忽略本章节。新建系统变量JAVA_HOME，变量值为实际JDK安装位置。在Path中添加%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin （注意用英文分号分隔）。新建系统变量CLASSPATH，变量值 - [JAVA语言SDK获取和安装](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0007.md): JAVA版本图像搜索的SDK推荐您通过 Maven 安装依赖的方式使用华为云 Java SDK：创建项目以idea开发工具为例(已有Maven 工程可跳过此步骤)：打开IntelliJ IDEA 开发工具。单击File - New - project...在New Project弹窗单击-Maven-单击Next。输入GroupId和Ar - [添加数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0008.md): 添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用AddDataParam类的setImageUrl、setItemId、setCustomTags、setCustomNumTags方法配置服务输入参数，配置完成后运行即可。添加数据调用示例代码如下：package com.huaweicloud.sdk.test; - [更新数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0009.md): 本章节对更新数据AK/SK方式使用SDK进行示例说明。更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用UpdateParam类的withItemId、withDesc、withCustomNumTags、withCustomTags配置服务输入参数，配置完成后运行即可。更新数据调用示例代码如下：package co - [检查数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0010.md): 本章节对检查数据AK/SK方式使用SDK进行示例说明。检查数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用CheckParam类的setItemId设置数据的服务实例级唯一标识，配置完成后运行即可。检查数据调用示例代码如下：package com.huaweicloud.sdk.test; import com.hu - [搜索数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0011.md): 本章节对搜索数据AK/SK方式使用SDK进行示例说明。搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用SearchParam类配置服务输入参数，其中使用SearchOptionalParam类配置服务的可选参数，配置完成后运行即可。搜索数据调用示例代码如下：package com.huaweicloud.sdk.tes - [删除数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0012.md): 本章节对删除数据AK/SK方式使用SDK进行示例说明。删除数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用DeleteParam类的withItemId配置数据的服务实例级唯一标识，配置完成后运行即可。删除数据调用示例代码如下：package com.huaweicloud.sdk.test; import com. - [Python开发环境配置](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0014.md): 使用图像搜索Python版本SDK包，需要您配置Python开发环境，步骤如下： - [Python语言SDK获取和安装](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0015.md): python语言SDK语言获取和安装推荐使用pip命令进行安装或使用pycharm进行安装，需要安装huaweicloudsdkcore包以及huaweicloudsdkimagesearch，参考方法如下： - [添加数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0016.md): 本章节对添加数据AK/SK方式使用SDK进行示例说明。添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化AddDataParam类中的image_url、custom_num_tags、custom_tags、desc、item_id、force配置服务输入参数，配置完成后运行即可。添加数据调用示例代码如下：# - [更新数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0017.md): 本章节对更新数据AK/SK方式使用SDK进行示例说明。更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化UpdateParam中的custom_num_tags、custom_tags、desc、item_id配置服务输入参数，配置完成后运行即可。更新数据调用示例代码如下：# coding: utf-8 fr - [检查数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0018.md): 本章节对检查数据AK/SK方式使用SDK进行示例说明。检查数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化CheckParam中的item_id参数配置数据的服务实例级唯一标识，配置完成后运行即可。搜过图片调用示例代码如下：# coding: utf-8 from huaweicloudsdkcore.auth - [搜索数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0019.md): 本章节对搜索数据AK/SK方式使用SDK进行示例说明。搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化SearchParam中的image_url、search_type、custom_tags、keywords、optional_params配置服务的输入参数，其中optionl_params为服务可选输入参数 - [删除数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0020.md): 本章节对删除数据AK/SK方式使用SDK进行示例说明。删除数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化DeleteParam中的item_id参数配置数据的服务实例级唯一标识，配置完成后运行即可。删除数据调用示例代码如下：# coding: utf-8 from huaweicloudsdkcore.au - [.NET开发环境配置](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0022.md): 使用图像搜索.NET版本SDK包，需要先配置.Net开发环境。从Visual Studio官网，下载最新版Visual Studio。下载完毕后，单击exe文件，开始安装。安装过程中选择工作负荷 > ASP.NET和Web开发，如图1所示，安装完成后启动即可。选择安装.NET环境依赖 - [.Net语言SDK获取和安装](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0023.md): .NET语言SDK的获取和安装可以使用可以通过命令方式安装或使用Visual Studio开发工具安装第三方引用，参考方法如下：使用Visual Studio开发工具安装第三方引用：单击工具->选择NuGet包管理器->单击管理解决方案的NuGet程序包，选择浏览中搜索并安装HuaweiCloud.SDK.Core及HuaweiCloud - [添加数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0024.md): 本章节对添加数据AK/SK方式使用SDK进行示例说明。添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用AddDataParam类中的ImageUrl、Keywords、CustomNumTags、CustomTags、Desc、ItemId、Force参数配置服务输入参数；配置完成后运行即可。添加数据调用示例代码如 - [更新数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0025.md): 本章节对更新数据AK/SK方式使用SDK进行示例说明。更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化UpdateParam中的custom_num_tags、custom_tags、desc、item_id配置服务输入参数，配置完成后运行即可。更新数据调用示例代码如下：using System; using - [检查数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0026.md): 本章节对检查数据AK/SK方式使用SDK进行示例说明。检查数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用CheckParam中的ItemId参数配置数据的服务实例级唯一标识，配置完成后运行即可。更新数据调用示例代码如下：using System; using System.Collections.Generic; u - [搜索数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0027.md): 本章节对搜索数据AK/SK方式使用SDK进行示例说明。搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用SearchParam类的ImageUrl、SearchType、OptionalParams、Keywords、CustomTags配置服务输入参数，其中OptionalParams为服务可选输入参数，配置完成后运行 - [删除数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0028.md): 本章节对删除数据AK/SK方式使用SDK进行示例说明。删除数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化DeleteParam中的ItemId参数配置数据的服务实例级唯一标识，配置完成后运行即可。删除数据调用示例代码如下：using System; using System.Collections.Generi - [GO开发环境配置](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0030.md): 使用图像搜索GO版本SDK包，需要您配置Go语言开发环境。如已经安装配置go开发环境，可跳过该步骤。在golang官网下载并安装对应的go版本，sdk支持 go 1.14 及以上版本。下载完成后按照提示安装，位置自选，比如安装到本地D:\develop\go。配置Go环境变量：右键“计算机>属性>高级系统设置>环境变量”，进行如下操作。新 - [GO语言SDK获取和安装](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0031.md): GO语言SDK语言获取和安装使用命令进行安装，参考方法如下： - [添加数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0032.md): 本章节对添加数据AK/SK方式使用SDK进行示例说明。添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用AddDataParam类中的ImageUrl、Keywords、CustomNumTags、CustomTags、Desc、ItemId、Force配置服务输入参数，配置完成后运行即可。添加数据调用示例代码如下： - [更新数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0033.md): 本章节对更新数据AK/SK方式使用SDK进行示例说明。更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化UpdateParam中的CustomNumTags、CustomTags、Desc、ItemId配置服务输入参数，配置完成后运行即可。更新数据调用示例代码如下：package main import ( - [检查数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0034.md): 本章节对检查数据AK/SK方式使用SDK进行示例说明。检查数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用CheckParam中的ItemId参数配置数据的服务实例级唯一标识，配置完成后运行即可。检查数据调用示例代码如下：package main import ( "fmt" "github.com/huawei - [搜索数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0035.md): 本章节对搜索数据AK/SK方式使用SDK进行示例说明。搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用SearchParam类的ImageUrl、SearchType、OptionalParams、Keywords、CustomTags配置服务输入参数，其中OptionalParams为服务可选输入参数，配置完成后运行 - [删除数据示例](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0036.md): 本章节对删除数据AK/SK方式使用SDK进行示例说明。删除数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化DeleteParam中的ItemId参数配置数据的服务实例级唯一标识，配置完成后运行即可。删除数据调用示例代码如下：package main import ( "fmt" "github ## 常见问题 - [有哪些途径可以使用图像搜索的API？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0006.md): 共有三种方式可以基于已构建好的请求消息发起请求。cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。cURL是一个命令行工具，用来执行各种URL操作和信 - [调用图像搜索的API失败时怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0007.md): 请确认当前账号是否欠费。如果欠费，请给账号充值。操作指导请参见华为云账户充值。您在创建和调用OBS桶时，需保证您的OBS桶与图像搜索在同一个区域，不支持跨区域使用。例如同为华北-北京一区域，具体请参见图像搜索地区和终端节点。根据API调用返回结果或者错误码查找原因。具体请参见图像搜索错误码。检查访问密钥AK/SK是否获取成功，获取方式请参 - [商品图片不创建图库，直接用网络图库搜索图片可以吗？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0017.md): 不可以，您需要自行提供用来搜索的图片库，利用图像搜索服务来创建实例将已有的图片库进行离线数据导入到OBS桶中，然后再进行搜索。通过使用图像搜索服务的自研API，您可以完整的使用本服务的的所有功能，具体使用方法请参考：图像搜索API。 - [有哪些途径可以使用图像搜索的API？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0006.md): 共有三种方式可以基于已构建好的请求消息发起请求。cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。cURL是一个命令行工具，用来执行各种URL操作和信 - [调用图像搜索的API失败时怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0007.md): 请确认当前账号是否欠费。如果欠费，请给账号充值。操作指导请参见华为云账户充值。您在创建和调用OBS桶时，需保证您的OBS桶与图像搜索在同一个区域，不支持跨区域使用。例如同为华北-北京一区域，具体请参见图像搜索地区和终端节点。根据API调用返回结果或者错误码查找原因。具体请参见图像搜索错误码。检查访问密钥AK/SK是否获取成功，获取方式请参 - [商品图片不创建图库，直接用网络图库搜索图片可以吗？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0017.md): 不可以，您需要自行提供用来搜索的图片库，利用图像搜索服务来创建实例将已有的图片库进行离线数据导入到OBS桶中，然后再进行搜索。通过使用图像搜索服务的自研API，您可以完整的使用本服务的的所有功能，具体使用方法请参考：图像搜索API。 - [调用服务时错误码显示“ModelArts.4204”怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0013.md): 调用接口出错后，返回的消息体中具体的错误代码及错误信息为：{ "error_code":"ModelArts.4204", "error_msg":"Request api error! The API is not subscribed." }表示您还未订阅该区域下的图像搜索服务，请您开通后再使用该服务。出现其它错误码及 - [错误码显示ModelArts.4603、ModelArts.4704怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0018.md): 如果在调用API时返回错误信息与错误码：调用接口出错后，返回的消息体中具体的错误代码及错误信息为：{ "error_code":"ModelArts.4603", "error_msg":"Obtaining the file from the URL failed." }表示从URL获取图片数据失败。可通过以下几个方面进 - [调用服务时错误码显示“ModelArts.4204”怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0013.md): 调用接口出错后，返回的消息体中具体的错误代码及错误信息为：{ "error_code":"ModelArts.4204", "error_msg":"Request api error! The API is not subscribed." }表示您还未订阅该区域下的图像搜索服务，请您开通后再使用该服务。出现其它错误码及 - [错误码显示ModelArts.4603、ModelArts.4704怎么处理？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0018.md): 如果在调用API时返回错误信息与错误码：调用接口出错后，返回的消息体中具体的错误代码及错误信息为：{ "error_code":"ModelArts.4603", "error_msg":"Obtaining the file from the URL failed." }表示从URL获取图片数据失败。可通过以下几个方面进 - [什么是区域与可用区？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0009.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属R - [如何关闭已申请的服务？](https://support.huaweicloud.com/imagesearch_faq/image_01_0042.md): 服务开通后，已申请的服务可在图像搜索服务控制台的服务列表页面内查看，如不想再使用本服务，无需关闭，不调用即可。 - [什么是区域与可用区？](https://support.huaweicloud.com/imagesearch_faq/imagesearch_01_0009.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属R - [如何关闭已申请的服务？](https://support.huaweicloud.com/imagesearch_faq/image_01_0042.md): 服务开通后，已申请的服务可在图像搜索服务控制台的服务列表页面内查看，如不想再使用本服务，无需关闭，不调用即可。