检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
com/v3/auth/tokens 请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如所示需要添加公共消息头到请求中。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式）。
有哪些途径可以使用图像搜索的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
图像搜索提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用。 同时图像搜索还提供多种编程语言的SDK供您使用，SDK的使用方法请参见：图像搜索SDK。 父主题： 使用前必读
Python开发环境配置 使用图像搜索Python版本SDK包，需要您配置Python开发环境，步骤如下： 从Python官网下载并安装合适的Python版本。请使用Python3.3以上版本，如下以Python3.7 版本为例进行说明。 从PyCharm官网下载并安装最新版本。
状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响
务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。
图像搜索服务软件开发工具包（ImageSearch SDK）是对图像搜索服务提供的REST API进行的封装，以简化用户的开发工作。 本章节以搜索数据接口为例，介绍如何使用ImageSearch Java SDK在本地开发，用户调用接口函数即可使用SDK功能。其他接口功能及支持的SDK可参加图像搜索SDK参考。
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
表示从URL获取图片数据失败。可通过以下几个方面进行排查： 请确保提供的URL支持HTTP/HTTPS请求协议，即格式为http/https url。 请检查存储图片的服务器是否稳定可靠，网络连接是否有异常，是否公网可访问。 请检查下载图片的content-type是否为标准类型，例如：imag
接口并发：每个用户的默认搜索接口并发为5QPS。有更高的接口并发需求请联系华为云客服，接口并发调整需要额外收费。 存储规格：创建服务实例的存储规格为当前实例可容纳索引个数上限，最大可创建5000万存储规格实例，有其他的的存储规格需求请联系华为云客服。默认不支持调整已创建服务实例的存储规格，有特殊需求需要调整，请联系华为云客服。
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API，您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 endp
只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费周期：按小时计费，实时扣费（账单出账时间通常在当前计费周期结束后一小时内，具体出账时间以系统为准）。 套餐包 扣费时使用数量会先在套餐包内进行抵扣，抵扣完后的剩余使用量默认转回按需计费方式。 套餐包相对于按需付费提供了更大的折扣，时间
Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。
单击右上角“Send”按钮发送请求。获取返回结果中的Token值（Token有效期为24小时）。 步骤五：调用服务 向已创建的“通用图像搜索”服务实例中添加数据，可以调用添加数据API实现，搜索数据、检查数据、更新数据、删除数据等操作。具体操作如下： 新建请求，请求方式为修改“POST”，按要求填写URL。
项目ID通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为GET https://{iam-endpoint}/v3/projects，其中{iam-endpoint}为IAM的终端节点。可以从地区和终端节点处获取。 响应示例如下，例如图像搜索服务部署的区域为"cn-nor
是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 item_id 是 String 数据的服务实例级唯一标识，字符长度范围为[1
参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时设置的实例名称。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 force 否
购买折扣套餐包。 创建服务实例 开通服务后，用户可以根据自身的业务需求和规模，在图像搜索服务“控制台->实例管理->实例创建“界面创建自定义配置的服务实例。 服务实例创建后，可以在“控制台->实例管理->实例概况”界面看到已创建的服务实例及其相应配置信息。 获取请求认证 调用图像
是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 force 否 Boolean
获取账号名和账号ID 在调用接口的时候，部分请求中需要填入账号名（domain name）和账号ID（domain_id）。获取步骤如下： 注册并登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
