检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
资源。 区域(Region):从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Regio
服务类型说明 公共说明 图像类说明
公共说明 名词解释 数据类型 数据类型,指用户需要搜索的主要数据类型,即用户创建服务实例用于搜索什么类型的数据。 例如:IMAGE,表示用户需要搜索的为图像数据。 服务模板 服务模板,指用户搜索数据的基础业务流程,即用户需要在业务中按照什么流程进行数据搜索。 例如:IMAGE->
图像类说明 图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。 通用图像搜索 搜索类型 通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型,用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT:
获取认证信息 使用服务API需要进行认证,推荐用户使用AK/SK方式。步骤如下: 登录华为云管理控制台。 鼠标移动至用户名处,在下拉列表中单击“我的凭证”。 选择“访问密钥”页签,单击“新增访问秘钥”按钮。 通过邮箱或者手机进行验证,输入对应的验证码。 单击“确定”,下载认证账号
计费,大于数量下限时按实际数量计费。 实例支持多个搜索类型时,索引存储数量超过存储下限时,按索引存储数量 * 搜索类型数计费。例如:当选择3种搜索类型"IMAGE"、"KEYWORD"、"TEXT"时,存储计费为1种搜索类型的索引存储数量费用*3。 搜索查询V2,添加数据V2默认QPS为5。
表5 AddDataRestInfo 参数 参数类型 描述 image_info image_info object 添加图像数据的相关信息,不同服务类型返回信息不同,具体可参见服务类型说明。 表6 image_info 参数 参数类型 描述 objects Array of objects
search_type 是 String 搜索类型,必须为服务实例支持的搜索类型,服务实例的搜索类型列表可在创建服务实例时进行配置。 说明: 可以使用枚举名或者枚举值(例如IMAGE/0),枚举值可能会变动,建议使用枚举名。 枚举值: IMAGE KEYWORD TEXT CATEGORY
进行新增。 value: 类型为数值,格式为double。 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 result String 更新数据完成,返回success。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code
参数 是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称,用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 item_id
参数 是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称,用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 force
MMS.1023 Service type don't support Search type. 当前服务类型不支持搜索类型 请检查搜索类型是否匹配。具体搜索类型可参考搜索类型。 MMS.1024 Config item error. 配置项错误 请检查创建实例时输入的配置项是否正确。
/WEBP。 图像尺寸默认要求最小边不小于64px,最大边不超过4096px。 图像文件大小要求不超过5M。 部分服务类型的约束限制存在差异,具体可参考服务类型说明。 文本类限制 针对图文跨模态检索场景的文本类限制: 文本默认支持简体中文/繁体中文/英语/法语/阿拉伯语/德语/俄
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 当调用API网关Silvan接口时,需要采用Token认证方式,需要使用“roles”为“op_service”的token,各服务的管理账号一般都具有op_service权限。
附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 如所示需要添加公共消息头到请求中。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型(格式)。 是 application/json
s url。 请检查存储图片的服务器是否稳定可靠,网络连接是否有异常,是否公网可访问。 请检查下载图片的content-type是否为标准类型,例如:image/gif、image/jpeg、image/png。建议:使用OBS的URL进行请求。 调用接口出错后,返回的消息体中具体的错误代码及错误信息为:
Explorer,在“代码示例”中选择“Python”。 图4 APIE 填写参数:service_name(实例名称)、search_type(搜索类型)和image_url(图片路径)。 例如:service_name输入general_image_test,search_type输入I