华为图像搜索
华为图像搜索连接器基于华为云图像搜索ImageSearch集成开发，即以图搜图，华为云图像搜索基于深度学习与图像识别技术，利用特征向量化与搜索能力，帮助客户从指定图库中搜索相同及相似的图片。包含“实例管理”和“图片管理”等执行动作。
连接参数
华为图像搜索连接器使用IAM认证，连接参数说明如表1所示。
名称 | 必填 | 说明 | 示例值/默认值 |
|---|---|---|---|
连接名称 | 是 | 设置连接名称。 | 华为图像搜索的连接 |
描述 | 否 | 对于连接的信息描述说明。 | description |
租户名 | 是 | IAM用户所属账号信息。了解账号与IAM用户的关系。 | domain |
用户名 | 是 | IAM用户名。 | name |
密码 | 是 | IAM用户的登录密码。 | - |
项目ID | 是 | 系统为用户自动生成的项目ID，单击“我的凭证 > API凭证”，根据项目获取。 | e9993fc787************a340f9c0f4 |
站点 | 是 | 站点。 | iam.cn-north-4.myhuaweicloud.com |
创建实例
通过创建实例，实例中会生成图片索引库，用来存放图片特征。
- 输入参数
用户配置创建实例执行动作，相关参数说明如表2所示。
表2 创建实例输入参数说明 参数
必填
说明
实例名称
是
要创建的实例名称，仅支持小写字母（a-z）、数字，横杠和下划线。以字母开头，长度在16位以内。
模型名称
是
模型名称，支持如下模型名称，有下拉框和输入框模式：
- common-search：通用图片搜索，适用于图片库中搜索相似内容或类别的图片。
- image-recommend：版权图片推荐，适用于版权摄影图片库中查找并推荐相同或相似版权图片。
- image-copyright：图片版权，适用于从海量图片库中快速识别侵权盗用图片。
描述
否
图片描述。
图片规格
否
实例的图片数量规格。默认为30000000（单位：张），当前仅支持默认规格。缺省值：30000000。
图片标签
否
图片自定义标签，每个实例最多支持10个标签，自定义标签不支持英文字母大写。
- 输出参数
用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考表3。
添加图片
将图片导入图片索引库，该图片可以是同一区域OBS桶内的图片或请求消息体里的图片，只有导入图片索引库的图片方可被搜索到。
- 输入参数
用户配置添加图片执行动作，相关参数说明如表4所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考表5。
搜索图片
从图片索引库中搜索相似图片。
- 输入参数
用户配置搜索图片执行动作，相关参数说明如表6所示。
表6 搜索图片输入参数说明 参数
必填
说明
实例名称
是
要创建的实例名称。
上传图片
否
图片文件Base64编码字符串，仅支持JPEG/JPG/PNG/BMP格式，图片最小边不小于100px，最大边不超过2048px。该参数与path二选一，如果两个参数都存在，则以file为主。
图片ID
否
图片库中的图片索引ID。
检索图像的数量
否
返回被检索图像的数量，取值为1~100的整数，默认为10，缺省值：10。
起始索引
否
偏移量，指定搜索结果返回起始位置，取值为大于或等于0的整数，默认为0。
图片自定义标签
否
图片自定义标签，最多不超过10个，格式为key：value对。
指定区域搜索
否
是否用图片中指定区域（参数box）进行搜索。默认为false，该参数目前仅对某些特定模型有效，其他模型暂不支持目标检测。 - true：用图片中指定区域（参数box）进行搜索。 - false：用全图进行搜索。缺省值：false。
x坐标
否
区域中x坐标的最小值，单位：像素。
y坐标
否
区域中y坐标的最小值，单位：像素。
宽度
否
区域的宽度，单位：像素。
高度
否
区域的高度，单位：像素。
- 输出参数
用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考表7。
