本文介绍图像搜索服务新增图片的四种方式,通过API新增 、 SDK新增(适用于小规模、实时的数据增量操作)、批量操作(适用于较大规模(百万级)、离线数据操作)和管控台图片新增(适用于功能体验场景)。请根据您的实际情况进行选择。

前提条件

已创建实例,具体请参见开通服务

控制台方式

  1. 登录图像搜索控制台
  2. 选择需要的服务类型。
    关于服务类型的具体说明请参见服务内容选择服务类型
  3. 单击目标实例。
    选择实例
  4. 选择图片新增
    新增图片新增图片参数设置如下所示。
    参数 对应API参数名称 说明 是否必选
    商品ID ProductId 商品唯一ID。最多支持256个字符。
    图片名称 PicName 图片名称,最多支持256个字符。
    说明
    • 商品ID+图片名称唯一确定一张图。
    • 如果图片具有相同的商品ID+图片名称,则以最后一次添加为准。
    上传图片 PicContent 图片内容本身,Base64编码。新增图片具体要求如下:
    • 图片大小要求不超过4 MB。
    • 图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。
    • 传输等待时间不超过5秒。
    • 服务类型为商品图片搜索,商标图片搜索和通用图片搜索时,图片长和宽像素要求大于等于100且小于等于4096。
    • 服务类型为布料图片搜索时,图片长和宽像素要求大于等于448且小于等于4096。
    • 图片中不能包含旋转信息。
    图片主体识别 Crop 是否进行主体识别。
    主体识别方式 - 主体识别的方式:
    • 系统自动识别:由系统进行主体识别,以识别的主体进行搜索,主体识别结果可以在Reponse中获取。
    • 自定义主体区域:进行主体识别且可自定义主体识别区域。若不设置自定义主体区域,则以整张图进行搜索。
    图片类目 CategoryId 新增图片时可以设置图片所属类目。
    自定义内容 CustomContent 用户自定义内容,最多支持4096个字符。
    整数型属性 IntAttr 整数类型属性、用于查询时过滤。
    字符串属性 StrAttr 字符串类型属性。最多支持128个字符。用于查询时过滤。
  5. 单击确认完成图片新增。

API方式

通过HTTP或HTTPS协议直接访问,需要按照签名机制进行身份验证,发送请求的RequestBody需要按照给定的格式进行传输。通过API新增图片默认为5 qps。具体请参见新增图片

SDK方式

图像搜索服务提供多个版本的SDK,您不需要关注签名验证以及RequestBody格式拼装等繁琐事情。当图片量较小且需要实时新增时,推荐使用该种方式。通过SDK新增图片默认为5 qps。具体请参见SDK参考。

批量操作

图像搜索服务与阿里云OSS对接,通过简单操作即可以将OSS中的图片批量导入到图像搜索服务中。适用于较大规模(百万级)、离线数据操作。更多详情请见批量操作