检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 图像搜索提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用。 同时图像搜索还提供多种编程语言的SDK供您使用,SDK的使用方法请参见:图像搜索SDK。 父主题: 使用前必读
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API,您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头,在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 en
公共说明 名词解释 数据类型 数据类型,指用户需要搜索的主要数据类型,即用户创建服务实例用于搜索什么类型的数据。 例如:IMAGE,表示用户需要搜索的为图像数据。 服务模板 服务模板,指用户搜索数据的基础业务流程,即用户需要在业务中按照什么流程进行数据搜索。 例如:IMAGE->
服务类型说明 公共说明 图像类说明
API 添加数据 V2 搜索查询 V2 检查数据 V2 更新数据 V2 删除数据 V2
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。 由于存在资源占用,单个服务实例的存储数量存在计
调用API实现功能 本章节通过Postman软件,调用通用图像搜索服务实例的添加数据API,帮助您快速熟悉API的使用方法,具体流程如下: 步骤一:开通服务 步骤二:创建实例 步骤三:配置环境 步骤四:Token认证鉴权 步骤五:调用服务 步骤六:删除实例 准备工作 已注册华为账
如何调用API 构造请求 认证鉴权 返回结果
API使用类 有哪些途径可以使用图像搜索的API? 调用图像搜索的API失败时怎么处理? 商品图片不创建图库,直接用网络图库搜索图片可以吗?
所有商品用于后续精准搜索。 请求高阶参数 通用商品搜索允许用户在调用API接口时传递高阶参数,以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶请求参数: 添加数据API do_det: 是否进行目标检测,默认为true。 box: 目标
状态码 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTPS的新版本协议。
TF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 例如对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息
参见服务类型说明。 图片中不能包含旋转信息。 image_url 否 String 图片的URL路径,目前支持公网http:/https url,图像入库时,与image_base64二选一。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 keywords
服务类型说明。 其他:图片中不能包含旋转信息。 image_url 否 String 图片的URL路径,目前支持公网http:/https url,图像入库时,与image_base64二选一。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
检查数据 V2 功能介绍 检查指定服务实例中的对应数据,支持指定ID检查和条件检查。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v2/{projec
根据API调用返回结果或者错误码查找原因。具体请参见图像搜索错误码。 检查访问密钥AK/SK是否获取成功,获取方式请参见获取AK/SK。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确,具体操作请参见《图像搜索API参考》。 联系服务人员 如果无法确定原因和解决问题,请联系华为云客服。
完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-tok
某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。 Token可通过调用获取用户Token接口获取,调用本服务API需要project级别的Token,即调用获取用户Token接口时,请求body中auth.scop
参见https://curl.haxx.se/。 编码 通过编码调用接口,组装请求消息,并发送处理请求消息。 REST客户端 Mozilla、Google都为REST提供了图形化的浏览器插件,发送处理请求消息。 针对Firefox,请参见Firefox RESTClient。 针对Chrome,请参见Postman。
删除数据 V2 功能介绍 删除指定服务实例中的对应数据,支持指定ID删除和条件删除。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v2/{projec