检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
附录 状态码 错误码 获取项目ID和名称 获取账号名和账号ID
服务类型说明 公共说明 图像类说明
Management，简称IAM）服务，IAM为图像搜索提供了用户认证和鉴权功能。 对象存储服务 对象存储服务（Object Storage Service，简称OBS）是稳定、安全、高效、易用的云存储服务。图像搜索服务涉及到对用户的数据处理，用户的大量数据采用OBS批量方式处理，可以提升云上处理的总体效率。
图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过Python、Java等编程语言调用图像搜索服务API进行数据的入库和搜索，帮助用户构建托管式的场景化搜索服务，打造智能化业务系统，提升业务效率。 使用准备 服务开通 使用前，
接口而定。 例如对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxx
获取认证信息 使用服务API需要进行认证，推荐用户使用AK/SK方式。步骤如下： 登录华为云管理控制台。 鼠标移动至用户名处，在下拉列表中单击“我的凭证”。 选择“访问密钥”页签，单击“新增访问秘钥”按钮。 通过邮箱或者手机进行验证，输入对应的验证码。 单击“确定”，下载认证账号
添加数据 V2 功能介绍 添加数据到用户指定的服务实例中。 服务实例需要用户在图像搜索服务管理控制台上创建。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
图像搜索服务软件开发工具包（ImageSearch SDK）是对图像搜索服务提供的REST API进行的封装，以简化用户的开发工作。 本章节以搜索数据接口为例，介绍如何使用ImageSearch Java SDK在本地开发，用户调用接口函数即可使用SDK功能。其他接口功能及支持的SDK可参加图像搜索SDK参考。
式提供给用户，用户通过实时访问和调用API获取图像搜索结果，帮助用户在图像库中进行相同或相似图像搜索。 SDK概述 图像搜索软件开发工具包（Image Search Software Development Kit）是对图像搜索提供的REST API进行的封装，以简化用户的开发工
图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取图像搜索结果，帮助用户在图像库中进行相同或相似图像搜索。 您可以使用本文档提供图像搜索服务API的描述、语法、参数说明及样例等内容，
对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户Token接口，返回如图1所示的消息头，其中“x-subject-token”就是需要获取的用户Token
服务区域仅支持“华为-北京四”。 请求body使用标准json格式，且大小不超过12M。 默认不保存用户的图像或视频等数据。 实例数量：每个用户默认可创建5个服务实例。如需创建更多服务实例，请联系华为云客服。 接口并发：每个用户的默认搜索接口并发为5QPS。有更高的接口并发需求请联系华为云客服，接口并发调整需要额外收费。
从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上，在下拉列表中选择“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。
在调用接口的时候，部分请求中需要填入账号名（domain name）和账号ID（domain_id）。获取步骤如下： 注册并登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID 父主题： 附录
一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。不过，在基础设施、BGP网络品质、资源的操作与配置等方面，中国大陆各个区域间区别不大，如果您或者您的目标用户在中国大陆，可以不用考虑不同区域造成的网络时延问题。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国
路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述
服装商品图像搜索 针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。 应用场景 商品图像搜索 基于用户提供的图像在商品库中进行搜索，找到同款或相似的商品，可以应用于商品搜索、推荐等业务中。 图1 商品图像搜索示例图 服装版型搜索 根据参考的
路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述
2021年9月 序号 功能名称 功能描述 阶段 相关文档 1 新版API文档上线 改进了本服务API的描述、语法、参数说明及样例等内容，帮助用户更加熟练运用服务。 商用 API参考 2020年4月 序号 功能名称 功能描述 阶段 相关文档 1 新增《快速入门》文档 帮助客户快速了解和使用本服务。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
