检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
基于用户提供的图像在商品库中进行搜索，找到同款或相似的商品，可以应用于商品搜索、推荐等业务中。 图1 商品图像搜索示例图 服装版型搜索 根据参考的服装图像搜索设计版型相似的服装，可以应用于服装设计、服装库管理等业务中。 父主题： 功能介绍
明。 添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用AddDataParam类中的ImageUrl、Keywords、CustomNumTags、CustomTags、Desc、ItemId、Force参数配置服务输入参数；配置完成后运行即可。 添加数据调用示例代码如下：
明。 添加数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用AddDataParam类中的ImageUrl、Keywords、CustomNumTags、CustomTags、Desc、ItemId、Force配置服务输入参数，配置完成后运行即可。 添加数据调用示例代码如下：
区域（Region） 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区（Availability Zone） 一个可用区是一个或多个物理数据中心
在欧洲地区有业务的用户，可以选择“欧洲-巴黎”区域。 云服务之间的关系 如果多个云服务一起搭配使用，需要注意： 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。
调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上，在下拉列表中选择“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。 调用API获取项目ID
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。 由于存在资源占用，单个服务实例的存储数量存在计
keywords 否 Array of strings 关键词列表，关键词数量范围为[1, 100]，关键词字符长度范围为[1, 64]。 说明： 支持关键词搜索的服务实例添加数据时，如给定此参数，则直接使用给定的keywords作为关键词，否则会自动生成对应的keywords。 optional_params
out.println(e.getErrorMsg()); } } } 执行示例代码文件，控制台输出检查数据结果即表示程序执行成功。 class RunCheckDataResponse { result: success data: class
搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用SearchParam类的ImageUrl、SearchType、OptionalParams、Keywords、CustomTags配置服务输入参数，其中OptionalParams为服务可选输入参数，配置完成后运行即可。 搜索数据调用示例代码如下：
搜索示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用SearchParam类的ImageUrl、SearchType、OptionalParams、Keywords、CustomTags配置服务输入参数，其中OptionalParams为服务可选输入参数，配置完成后运行即可。 搜索数据调用示例代码如下：
必须为服务实例custom_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。 value: 标签值列表，列表内多个标签值为“或”关系，即满足一个即可。列表长度范围为[1, 32]，标签值类型为字符串，字符长度范围为[1, 64]。 custom_num_tags 否 Map<String
AK/SK，代码中可以使用初始化SearchParam中的image_url、search_type、custom_tags、keywords、optional_params配置服务的输入参数，其中optionl_params为服务可选输入参数，配置完成后运行即可。 搜索数据调用示例代码如下：
必须为服务实例custom_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。 value: 标签值列表，列表内多个标签值为“或”关系，即满足一个即可。列表长度范围为[1, 32]，标签值类型为字符串，字符长度范围为[1, 64]。 custom_num_tags 否 Map<String
"category": 0 } ] } } 商品类目 通用商品搜索支持的商品类目详见表1。 表1 通用商品类目表 类目ID 英文描述 中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4
终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 imagesearch
Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝
获取认证信息 使用服务API需要进行认证，推荐用户使用AK/SK方式。步骤如下： 登录华为云管理控制台。 鼠标移动至用户名处，在下拉列表中单击“我的凭证”。 选择“访问密钥”页签，单击“新增访问秘钥”按钮。 通过邮箱或者手机进行验证，输入对应的验证码。 单击“确定”，下载认证账号
https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”。 在“Headers”列表中添加“KEY”为“Content-Type”，“VALUE”为“application/json”。 选中“Body”的配置项，选中“raw”，在空白处添加以下代码。
Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
