图像搜索：图片新增

控制台方式

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。 图片中不能包含旋转信息。 重要 这里指的是图片本身，base64编码。如果您上传的是图片URL，请参考SDK中的实例代码Add接口。	是
   图片主体识别	Crop	是否进行主体识别。	是
   主体识别方式	不涉及	主体识别的方式： 系统自动识别：由系统进行主体识别，以识别的主体进行搜索，主体识别结果可以在Reponse中获取。 自定义主体区域：进行主体识别且可自定义主体识别区域。若不设置自定义主体区域，则以整张图进行搜索。	是
   图片类目	CategoryId	新增图片时可以设置图片所属类目。 说明 商品图片搜索服务内置了自动类目预测功能，如果此字段没有被指定，则上传图片后图像搜索会默认自动预测图片所属类目，并将预测后的类目一并索引到引擎中。预测的类目结果可在Response中获取。 在搜索过程中商品图片搜索服务也会对图片进行自动类目预测，并在预测后的类目中进行相似图片搜索，以此来缩小搜索范围提高搜索准确度。 对于商品图片搜索服务，建议选择默认的自动类目预测功能。 对于布料、商标、通用搜索、版权、工业五金、家具家居图片搜索，不论是否设置类目，系统都会将类目设置为88888888。 类目列表请参见类目参考。 重要 如果在上传图片过程中指定了类目，则在搜索过程中也要指定相同的类目进行检索，否则会出现原图搜不到原图的情况。	否
   自定义内容	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中的图片批量导入到图像搜索服务中。适用于较大规模（百万级）、离线数据操作。更多详情请见批量操作。