检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用SDK(Python) Python开发环境配置 Python语言SDK获取和安装 添加数据示例 更新数据示例 检查数据示例 搜索数据示例 删除数据示例
使用SDK(.NET) .NET开发环境配置 .Net语言SDK获取和安装 添加数据示例 更新数据示例 检查数据示例 搜索数据示例 删除数据示例
如何调用API 构造请求 认证鉴权 返回结果
附录 状态码 错误码 获取项目ID和名称 获取账号名和账号ID
功能介绍 通用搜索 商品搜索
API使用类 有哪些途径可以使用图像搜索的API? 调用图像搜索的API失败时怎么处理? 商品图片不创建图库,直接用网络图库搜索图片可以吗?
公共说明 名词解释 数据类型 数据类型,指用户需要搜索的主要数据类型,即用户创建服务实例用于搜索什么类型的数据。 例如:IMAGE,表示用户需要搜索的为图像数据。 服务模板 服务模板,指用户搜索数据的基础业务流程,即用户需要在业务中按照什么流程进行数据搜索。 例如:IMAGE->商品搜索
图像类说明 图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。 通用图像搜索 搜索类型 通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型,用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT
Net语言SDK获取和安装 .NET语言SDK的获取和安装可以使用可以通过命令方式安装或使用Visual Studio开发工具安装第三方引用,参考方法如下: 使用 .NET CLI 工具 dotnet add package HuaweiCloud.SDK.Core dotnet
SDK代码示例自动生成 API Explorer提供API检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。 您只需要在API Explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境CloudIDE中完成代码的构建、调试、运行等操作。
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 当调用API网关Silvan接口时,需要采用Token认证方式,需要使用“roles”为“op_service”的token,各服务的管理账号一般都具有op_service
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时,返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便我们尽快帮您解决问题。 错误响应说明 当接口调用出错时,会返回错误码及错误信息说明
调用API实现功能 本章节通过Postman软件,调用通用图像搜索服务实例的添加数据API,帮助您快速熟悉API的使用方法,具体流程如下: 步骤一:开通服务 步骤二:创建实例 步骤三:配置环境 步骤四:Token认证鉴权 步骤五:调用服务 步骤六:删除实例 准备工作 已注册华为账号
有哪些途径可以使用图像搜索的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见
获取项目ID和名称 操作场景 在调用接口的时候,部分请求中需要填入项目ID或项目名称,所以需要获取到项目ID和名称。有如下两种获取方式: 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上,在下拉列表中选择“我的凭证”。
使用限制 受技术、成本与交互多种因素制约,图像搜索服务存在一些使用限制。其中系统级限制,是针对服务整体的约束。除系统级限制外,各种服务子项还有独立的使用限制条件。 系统级约束 服务区域仅支持“华为-北京四”。 请求body使用标准json格式,且大小不超过12M。 默认不保存用户的图像或视频等数据
搜索数据示例 本章节对搜索数据AK/SK方式使用SDK进行示例说明。 搜索示例代码只需将AK/SK信息替换为实际AK/SK,代码中可以使用SearchParam类的ImageUrl、SearchType、OptionalParams、Keywords、CustomTags配置服务输入参数
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API,您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头,在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 endpoint
添加数据示例 本章节对添加数据AK/SK方式使用SDK进行示例说明。 添加数据示例代码只需将AK/SK信息替换为实际AK/SK,代码中可以使用AddDataParam类中的ImageUrl、Keywords、CustomNumTags、CustomTags、Desc、ItemId、
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。 由于存在资源占用,单个服务实例的存储数量存在计费下限