检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 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 构造请求 认证鉴权 返回结果
调用API实现功能 本章节通过Postman软件,调用通用图像搜索服务实例的添加数据API,帮助您快速熟悉API的使用方法,具体流程如下: 步骤一:开通服务 步骤二:创建实例 步骤三:配置环境 步骤四:Token认证鉴权 步骤五:调用服务 步骤六:删除实例 准备工作 已注册华为账
API使用类 有哪些途径可以使用图像搜索的API? 调用图像搜索的API失败时怎么处理? 商品图片不创建图库,直接用网络图库搜索图片可以吗?
所有商品用于后续精准搜索。 请求高阶参数 通用商品搜索允许用户在调用API接口时传递高阶参数,以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶请求参数: 添加数据API do_det: 是否进行目标检测,默认为true。 box: 目标
TF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 例如对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息
完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-tok
状态码 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTPS的新版本协议。
参见服务类型说明。 图片中不能包含旋转信息。 image_url 否 String 图片的URL路径,目前支持公网http:/https url,图像入库时,与image_base64二选一。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 keywords
服务类型说明。 其他:图片中不能包含旋转信息。 image_url 否 String 图片的URL路径,目前支持公网http:/https url,图像入库时,与image_base64二选一。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
更新数据 V2 功能介绍 更新指定服务实例中的对应数据。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v2/{project_id}/mms/{ser
检查数据 V2 功能介绍 检查指定服务实例中的对应数据,支持指定ID检查和条件检查。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v2/{projec
某种权限。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。
根据API调用返回结果或者错误码查找原因。具体请参见图像搜索错误码。 检查访问密钥AK/SK是否获取成功,获取方式请参见获取AK/SK。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确,具体操作请参见《图像搜索API参考》。 联系服务人员 如果无法确定原因和解决问题,请联系华为云客服。