文档

图片新增

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

说明

如需了解更多产品详情和获取技术支持,请单击在线咨询或通过钉钉群(35035130)联系我们。

前提条件

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

控制台方式

  1. 登录图像搜索控制台

  2. 在左侧导航栏中,选择需要的服务类型。本文以商品图片搜索为例介绍。

    关于服务类型的具体说明请参见服务内容商品搜索

  3. 单击目标实例。

    选择实例

  4. 选择图片新增

    新增图片新增图片参数设置如下所示。

    参数

    对应API参数名称

    说明

    是否必选

    商品ID

    ProductId

    商品唯一ID。最多支持256个字符。

    图片名称

    PicName

    图片名称,最多支持256个字符。

    说明

    商品ID+图片名称唯一确定一张图

    重要

    如果图片具有相同的商品ID+图片名称,则以最后一次添加为准。即如果图片具有相同的商品ID+图片名称,则不管图片本身是否相同,后一张图片都会覆盖前一张图片。

    上传图片

    PicContent

    图片内容本身,Base64编码。新增图片具体要求如下:

    • 图片大小要求不超过4 MB。

    • 图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。

    • 传输等待时间不超过5秒。

    • 服务类型为商品图片搜索、通用图片搜索、家具家居图片搜索、工业五金图片搜索时,图片长和宽像素要求大于等于100且小于等于4096px。

    • 服务类型为商标图片搜索时,图片长和宽像素要求大于等于200且小于等于4096px。

    • 服务类型为布料图片搜索时,图片长和宽像素要求大于等于448且小于等于4096px。

    • 图片中不能包含旋转信息。

    重要

    这里指的是图片本身,base64编码。如果您上传的是图片URL,请参考SDK中的实例代码Add接口

    图片主体识别

    Crop

    是否进行主体识别。

    主体识别方式

    不涉及

    主体识别的方式:

    • 系统自动识别:由系统进行主体识别,以识别的主体进行搜索,主体识别结果可以在Response中获取。

    • 自定义主体区域:进行主体识别且可自定义主体识别区域。若不设置自定义主体区域,则以整张图进行搜索。

    图片类目

    CategoryId

    新增图片时可以设置图片所属类目。

    说明
    1. 商品图片搜索服务内置了自动类目预测功能,如果此字段没有被指定,则上传图片后图像搜索会默认自动预测图片所属类目,并将预测后的类目一并索引到引擎中。预测的类目结果可在Response中获取。

    2. 在搜索过程中商品图片搜索服务也会对图片进行自动类目预测,并在预测后的类目中进行相似图片搜索,以此来缩小搜索范围提高搜索准确度。

    3. 对于商品图片搜索服务,建议选择默认的自动类目预测功能。

    4. 对于布料、商标、通用搜索、版权、工业五金、家具家居图片搜索,不论是否设置类目,系统都会将类目设置为88888888。

    5. 类目列表请参见类目参考

    重要

    如果在上传图片过程中指定了类目,则在搜索过程中也要指定相同的类目进行检索,否则会出现原图搜不到原图的情况。

    自定义内容

    CustomContent

    用户自定义内容,最多支持4096个字符。

    说明

    图片的CustomContent会在搜索结果中自动关联出来。通过CustomContent字段,您可以填写图片的URL地址,图片额外附加信息等,以便与您的业务关联。

    整数型属性

    IntAttr

    整数类型属性、用于查询时过滤。

    说明

    整型类型属性与图片查询时的过滤条件组合使用,以起到过滤查询的功能。请参考条件过滤

    整数型属性

    IntAttr2

    整数类型属性、用于查询时过滤。

    说明
    • 整型类型属性与图片查询时的过滤条件组合使用,以起到过滤查询的功能。请参考条件过滤

    • 2023年1月3号之后创建的实例才能使用。

    字符串属性

    StrAttr

    字符串类型属性。最多支持128个字符。用于查询时过滤。

    说明

    字符串类型属性与图片查询时的过滤条件组合使用,以起到过滤查询的功能。请参考条件过滤

    字符串属性

    StrAttr2

    字符串类型属性。最多支持128个字符。用于查询时过滤。

    说明
    • 字符串类型属性与图片查询时的过滤条件组合使用,以起到过滤查询的功能。请参考条件过滤

    • 2023年1月3号之后创建的实例才能使用。

  5. 单击确认完成图片新增。

API方式

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

SDK方式

图像搜索服务提供多个版本的SDK,您不需要关注签名验证以及RequestBody格式拼装等繁琐事情。当图片量较小且需要实时新增时,推荐使用该种方式。通过SDK新增图片,10W规格套餐为1 QPS,其余套餐规格均为5 QPS。具体请参见Add接口

批量操作

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