检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。
source ItemSource object 数据的元信息，不同数据包含的字段可能不同。 表8 ItemSource 参数 参数类型 描述 desc String 数据描述信息。 custom_tags Map<String,String> 数据自定义字符标签。
表3 RangeParam 参数 是否必选 参数类型 描述 from 否 Double 数值下界，默认包含该下界。 to 否 Double 数值上界，默认包含该上界。
source ItemSource object 数据的元信息，不同数据包含的字段可能不同。 表9 ItemSource 参数 参数类型 描述 desc String 数据描述信息。 custom_tags Map<String,String> 数据自定义字符标签。
其他：图片中不能包含旋转信息。 image_url 否 String 图片的URL路径，目前支持公网http:/https url，图像入库时，与image_base64二选一。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。
若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。
公共配置主要包含如下内容： 实例描述（desc）: 服务实例描述信息，用于对服务实例进行文字说明或备注。 字符标签（custom_tags）: 自定义字符标签列表，用于添加数据时设置标签值，并在搜索时进行枚举过滤。
表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 imagesearch.cn-north-4.myhuaweicloud.com 华北-北京一 cn-north-1 imagesearch.cn-north-1.myhuaweicloud.com
value: 类型为字符串，字符长度范围为[1, 64]。 custom_num_tags 否 Map<String,Number> 数据的自定义数值标签，用于进行条件过滤。格式为键值对{key:value}。
发送“POST https://IAM的Endpoint/v3/auth/tokens”，获取IAM的Endpoint及消息体中的区域名称，请参见地区和终端节点。
文本长度要求不超过512字符。
图像类说明 图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。 通用图像搜索 搜索类型 通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。
请求url中需要包含服务ID 请检查请求url中是否包含服务ID。 ModelArts.4202 Request url format invalid. 请求url格式不合法 请检查请求url格式是否合法。 ModelArts.4203 Access denied!
基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。
访问秘钥为credentials.csv文件，包含AK/SK信息。 图6 获取AK/SK 运行代码示例，获取搜索结果。 图7 获取结果
您可以使用本文档提供图像搜索服务API的描述、语法、参数说明及样例等内容，进行相关操作，例如图像搜索包含的创建实例、搜索图片和删除图片等具体接口使用说明。支持的全部操作请参见API概览。 在调用图像搜索API之前，请确保已经充分了解图像搜索相关概念，详细信息请参见产品介绍。
获取步骤如下： 注册并登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID 父主题： 附录
204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。
调用API实现功能 本章节通过Postman软件，调用通用图像搜索服务实例的添加数据API，帮助您快速熟悉API的使用方法，具体流程如下： 步骤一：开通服务 步骤二：创建实例 步骤三：配置环境 步骤四：Token认证鉴权 步骤五：调用服务 步骤六：删除实例 准备工作 已注册华为账号
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
