检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
功能介绍 通用商品图像搜索 针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索。 服装商品图像搜索 针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。 应用场景 商品图像搜索 基于用户提供的图像在商品库中进行
调用说明 图像搜索提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用。 同时图像搜索还提供多种编程语言的SDK供您使用，SDK的使用方法请参见：图像搜索SDK。 父主题： 使用前必读
例如对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxx为project的name，获取方法请参见获取用户名、账号名和项目name。
图像搜索服务使用简介 图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过Python、Java等编程语言调用图像搜索服务API进行数据的入库和搜索，帮助用户构建托管式的场景化搜索服务，打造智能化业务系统，提升业务效率。
要选择对应区域，各服务部署的区域具体请参见终端节点。 单击页面右上角的“开通服务”按钮，开通图像搜索服务。 图1 开通服务 服务只需要开通一次即可，后面使用时无需再开通。 整体开通图像搜索服务后，具体的搜索服务实例需要单独创建。 调用SDK 安装Python环境并获取SDK软件包。
客服。 图像类限制 图像格式默认支持PNG/BMP/JPG/JPEG/WEBP。 图像尺寸默认要求最小边不小于64px，最大边不超过4096px。 图像文件大小要求不超过5M。 部分服务类型的约束限制存在差异，具体可参考服务类型说明。 文本类限制 针对图文跨模态检索场景的文本类限制：
选中“Body”的配置项，选中“raw”，在空白处添加以下代码。 图2 Token认证鉴权 图中代码红框内加粗的蓝色字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，project name为服务的部署区域，获取方法请登录我的凭证获取。
Token为空 发送的HTTP请求header中没有带x-auth-token的token请求认证信息，请检查发送的请求。 ModelArts.4102 Parse Token error. 解析Token失败 发送的HTTP请求header中x-auth-token的token请求认
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
JAVA语言SDK获取和安装 JAVA版本图像搜索的SDK推荐您通过 Maven 安装依赖的方式使用华为云 Java SDK： 首先您需要在您的操作系统中下载 并 安装Maven 。 安装配置完成后，输入命令“mvn -v”,显示如下图 Maven版本信息 表示成功。 Maven
准备环境 在使用图像搜索SDK时，各语言需要准备的环境，参考表1。 表1 开发环境 开发语言 准备项 说明 JAVA 安装JDK JAVA环境开发配置，支持 Java JDK 1.8 及其以上版本，推荐通过Maven 安装依赖的方式使用JAVA版本SDK。 PYTHON 安装python
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API，您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 en
huaweicloudsdkimagesearch.v2 import * if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量
搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化SearchParam中的image_url、search_type、custom_tags、keywords、optional_params配置服务的输入参数，其中optionl_params为服务可选输入参数，配置完成后运行即可。
static void Main(string[] args) { //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 //本示例以ak和sk保存在环境
com/huaweicloud/huaweicloud-sdk-go-v3/core/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量
eicloud-sdk-go-v3/core/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变
修改PATH变量，末尾增加GO的编译器路径“;%GOROOT%\bin"，中间分隔符是【;】。 修改CLASSPATH变量，末尾增加GO的编译器路径“;%GOROOT%\lib"，中间分隔符是【;】。 在vs code官网，下载安装操作系统的vs code。 安装go语言的插件Go和 Go Critic。
public static void main(String[] args) { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 // 本示例以ak和sk保存在环
public static void main(String[] args) { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 // 本示例以ak和sk保存在环
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
