检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
有哪些途径可以使用图像搜索的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam
和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 imagesearch.cn-north-4.myhuaweicloud
Key)加密调用请求。 通过API网关向下层服务发送请求时，必须使用AK、SK对请求进行签名。 Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Tok
业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
请确认当前账号是否欠费。如果欠费，请给账号充值。操作指导请参见华为云账户充值。 您在创建和调用OBS桶时，需保证您的OBS桶与图像搜索在同一个区域，不支持跨区域使用。例如同为“华北-北京一”区域，具体请参见图像搜索地区和终端节点。 根据API调用返回结果或者错误码查找原因。具体请参见图像搜索错误码。
对象存储服务 对象存储服务（Object Storage Service，简称OBS）是稳定、安全、高效、易用的云存储服务。图像搜索服务涉及到对用户的数据处理，用户的大量数据采用OBS批量方式处理，可以提升云上处理的总体效率。 图像搜索服务支持从OBS上采用临时授权或者匿名公开授权的方式获取数据并进行处理。
可用区（Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置
每小时整点结算，由于存在资源占用情况和计费下限，详情请参见图像搜索价格详情。 只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费周期：按小时计费，实时扣费（账单出账时间通常在当前计费周期结束后一小时内，具体出账时间以系统为准）。 套餐包 扣费时使用数量会先
可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 请检查图片是否过大，或网络延时过长，如果图片过大，在保证图片清晰度前提下可以对图片进行等比例
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求
未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414
数据的服务实例级唯一标识，字符长度范围为[1, 256]。 item_id/custom_tags/custom_num_tags中必须给定至少一个参数，以支持对服务实例中的数据进行指定ID检查或条件检查。 如给定item_id参数，则进行指定ID检查，否则进行条件检查。 最小长度：1
环境所示。选择好目标Python之后单击页面下方“Apply”完成配置。 图2 PyCharm配置python环境 在PyCharm中新建一个项目，并单击左下方“Terminal”按钮。分别执行以下命令安装SDK（该SDK支持Python3及以上版本）。参考方法如下： pip 安装：
数据的服务实例级唯一标识，字符长度范围为[1, 256]。 item_id/custom_tags/custom_num_tags中必须给定至少一个参数，以支持对服务实例中的数据进行指定ID删除或条件删除。 如给定item_id参数，则进行指定ID删除，否则进行条件删除。 custom_tags
BS路径存在且可访问，如果路径存在，请确保设置OBS桶策略为公共桶。建议：不要使用跨区域的OBS路径，如果OBS与调用服务部署区域不属于同一个区域，建议本地下载图片后使用image_base64的调用方式。 父主题： 错误码问题
针对支持全量召回的场景，使用全量召回时要求offset必须为0。 last_item 否 SearchAfterParam object 前一次搜索的最后一个搜索结果的排序信息。仅对全量召回场景生效，可将上一次搜索返回结果中的last_item字段直接用于此处。 目前仅有KEYWORD支持全量召回。
添加数据 V2 功能介绍 添加数据到用户指定的服务实例中。 服务实例需要用户在图像搜索服务管理控制台上创建。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
使用限制 受技术、成本与交互多种因素制约，图像搜索服务存在一些使用限制。其中系统级限制，是针对服务整体的约束。除系统级限制外，各种服务子项还有独立的使用限制条件。 系统级约束 服务区域仅支持“华为-北京四”。 请求body使用标准json格式，且大小不超过12M。 默认不保存用户的图像或视频等数据。
独创建。 步骤二：创建实例 以创建“通用图像搜索”服务实例为例，具体操作步骤如下： 在控制台，单击左侧导航栏“实例管理->实例创建”，进入到实例创建页面。 按图中所示填写参数，其余选项保持默认。 填写完成后，单击“立即创建”，弹出窗口提示创建成功后，您可以前往“实例概况”查看创建的实例。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
