准备环境和资源

开始教程前，请按以下步骤准备环境和资源：

1. 访问阿里云免费试用。单击页面右上方的登录/注册按钮，并根据页面提示完成账号登录（已有阿里云账号）、账号注册（尚无阿里云账号）或实名认证（根据试用产品要求完成个人实名认证或企业实名认证）。

2. 成功登录后，在产品类别下选择AI与机器学习>图像搜索，单击图像搜索卡片下的立即试用。

3. 在配置图像搜索信息面板，完成参数配置。完成本教程需要的配置如下，未提及的配置可保持默认。

   配置项	描述	示例值
   地域	图像搜索服务所在地域。 华东2（上海） 华东1（杭州） 华北2（北京） 华南1（深圳） 说明 地域选定后不可更改，请谨慎操作。	华东1（杭州）
   服务类型	图像搜索服务主要提供七种业务场景，详情如下： 说明 本文以商品图片搜索为例。 商品图片搜索 应用于各类电商平台拍照购物、商品推荐等场景。通过输入商品图片，在商品库中准确找到同款或者相似商品。 通用图片搜索 应用于图片版权保护，图片相似推荐等场景。通过输入具有相同元素或者主体内容的图片，在海量图片库中找到相同或者相似的图片。 布料图片搜索 应用于布料电商、纺织生产布料查找等场景。通过输入布料图片，可以在布料库中准确地找到与输入相同或相似纹理的布料，返回对应的布料信息。 商标图片搜索 应用于商标查找、商标去重等场景。通过输入商标图片，可以在商标库中准确地找到与输入相同或相似的商标，返回对应的商标信息。 版权图片搜索 应用于图片侵权检测、版权图片溯源等场景。通过输入图片，可以在自建有版权的图库中准确找到原图，有效避免图片拼接、Logo、水印、翻转、局部、色彩变换等因素对搜索效果的影响。 家具家居图片搜索 应用于家具、家居类图片查找，可以在家具、家居类图片库中准确找到与输入图片相同或相似的家具、家居商品，便于快速通过图片内容变现等场景。 工业五金图片搜索 应用于工业五金类商品图片快速查找，可以快速在工业五金品中快速找到同款或相似款商品，便于快速找到工业五金品详情，提高工业五金类网站的信息查找效率。 说明 服务类型选定后不可更换，请谨慎选择。	商品图片搜索
   实例名称	实例名称为必填项。要求如下： 由小写英文字母和数字组成。 首字母必须为英文字母。 名称长度为4~20个字符。 如果提示实例名称格式错误，请您检查实例名称是否已经填写，如果已经填写请您检测实例名称格式是否符合上述要求。 说明 实例名称确认后不可修改，请谨慎操作。	demoImagesearch1

4. 配置完成后，单击立即试用并按照页面提示完成试用申请。

5. 完成试用申请后，系统将会自动为您创建实例。您可以访问图像搜索管理控制台，在页面左上方选择试用申请时配置的地域，如华东1（杭州），然后刷新页面查看，实例创建需要约3~5分钟，当实例状态为正常运行时，即可正常使用。

访问实例

2

在开通图像搜索免费试用后，系统会为您创建一个图像搜索实例，通过图像搜索控制台可访问您创建的图像搜索实例，进行图片新增、图片查询等操作。

1. 登录图像搜索控制台，在顶部菜单栏左上角处选择您创建实例的所属地域，例如：华东1（杭州）地域。

2. 在左侧导航栏以图搜图目录中选择以您创建实例是配置的服务类型，例如：商品图片搜索，进入到实例列表，查看您创建的图像搜索实例。

   

3. 单击实例ID或操作，即可对实例进行图片新增、相似图片搜索等相关功能操作。

图片新增

5

1. 在实例列表中，单击操作，进入实例详情页面。

   

2. 选择图片新增选项卡，上传图片并填写商品ID、图片名称等选项。新增图片参数设置如下表所示。

   参数	说明	是否必选	示例值
   商品ID	商品唯一ID。最多支持256个字符。一个商品可以有多张图片。	是	12345
   图片名称	图片名称，最多支持256个字符。 商品ID+图片名称唯一确定一张图。 如果图片具有相同的商品ID+图片名称，则以最后一次添加为准。即如果图片具有相同的商品ID+图片名称，则不管图片本身是否相同，后一张图片都会覆盖前一张图片。	是	12345.jpg
   上传图片	图片内容本身，Base64编码。新增图片具体要求如下： 图片大小要求不超过4 MB。 图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。 传输等待时间不超过5秒。 服务类型为商品图片搜索、通用图片搜索、家具家居图片搜索、工业五金图片搜索时，图片长和宽像素要求大于等于100且小于等于4096px。 服务类型为商标图片搜索时，图片长和宽像素要求大于等于200且小于等于4096px。 服务类型为布料图片搜索时，图片长和宽像素要求大于等于448且小于等于4096px。 图片中不能包含旋转信息。	是	请上传图片文件
   图片主体识别	是否进行主体识别。	是	开启
   主体识别方式	主体识别的方式： 系统自动识别：由系统进行主体识别，以识别的主体进行搜索，主体识别结果可以在Reponse中获取。 自定义主体区域：进行主体识别且可自定义主体识别区域。若不设置自定义主体区域，则以整张图进行搜索。	是	系统自动识别
   图片类目	新增图片时可以设置图片所属类目。 商品图片搜索服务内置了自动类目预测功能，如果此字段没有被指定，则上传图片后图像搜索会默认自动预测图片所属类目，并将预测后的类目一并索引到引擎中。预测的类目结果可在Response中获取。 在搜索过程中商品图片搜索服务也会对图片进行自动类目预测，并在预测后的类目中进行相似图片搜索，以此来缩小搜索范围提高搜索准确度。 对于商品图片搜索服务，建议选择默认的自动类目预测功能。 对于布料、商标、通用搜索、版权、工业五金、家具家居图片搜索，不论是否设置类目，系统都会将类目设置为88888888。 类目列表请参见类目参考。 如果在上传图片过程中指定了类目，则在搜索过程中也要指定相同的类目进行检索，否则会出现原图搜不到原图的情况。	否	可默认不选择
   自定义内容	用户自定义内容，最多支持4096个字符。图片的CustomContent会在搜索结果中自动关联出来。 通过CustomContent字段，您可以填写图片的URL地址，图片额外附加信息等，以便与您的业务关联。	否	这是一个图片的描述信息
   整数型属性	整数型属性，可自定义填写，填写内容必须为整数，最多支持9位数字。 整型类型属性与相似图片查询时的过滤条件组合使用，以起到过滤查询的功能。请参考条件过滤。	否	22
   字符串属性	字符串类型属性，可自定义填写，填写内容为字符串类型，最多支持128个字符。 字符串属性用于查询时过滤。字符串类型属性与相似图片查询时的过滤条件组合使用，以起到过滤查询的功能。请参考条件过滤。	否	top

   

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

4. 为了保证在相似图片查询时能有更好的试用效果，可再多添加几张相似图片（上衣）或不同类别的图片（牛仔裤、鞋子等）。通过相似图片或不同类别的图片并存的情况下，体验相似图片查询的能力。

相似图片搜索

5

1. 单击图片搜索选项卡，上传搜索图片并填写搜索参数。图片搜索参数设置如下表所示。

   参数	说明	是否必选	示例值
   搜索类型	包括两种搜索类型： SearchByPic：根据图片搜索相似图片。默认选项。 SearchByName：根据已添加的图片搜索相似图片。	是	SearchByPic 根据图片搜索相似图片
   上传图片	图片内容本身，Base64编码。新增图片具体要求如下： 图片大小要求不超过4 MB。 图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。 传输等待时间不超过5秒。 服务类型为商品图片搜索，商标图片搜索和通用图片搜索时，图片长和宽像素要求大于等于100且小于等于4096。 服务类型为布料图片搜索时，图片长和宽像素要求大于等于448且小于等于4096。 图片中不能包含旋转信息。	是	请上传要搜索的图片文件
   图片主体识别	在图片搜索过程中是否需要对上传图片进行主体识别。 为true时：进行主体识别，包括系统自动识别和自定义主体识别。具体请参见主体识别方式参数介绍。 为false时：不进行主体识别，以整张图进行搜索。 说明 对于布料图片搜索，此参数会被忽略，系统会以整张图进行搜索。	是	开启
   主体识别方式	主体识别的方式： 系统自动识别：由系统自动进行主体识别，以识别的主体进行搜索，主体识别结果可以在Response中获取。 自定义主体区域：可自定义主体识别区域。格式为x1,x2,y1,y2，其中x1,y1为左上角点，x2,y2为右下角点。单击此选项可以通过拖拽的方式框选图片主体区域。若不设置自定义主体区域，则以整张图进行搜索。 说明 对于布料图片搜索，此参数会被忽略，系统会以整张图进行搜索。	是	系统自动识别
   图片类目	图片类目即CategoryId。图片搜索过程中可以指定图片所属类目，详情请参见类目参考。 对于商品搜索，如果设置类目，则以设置的为准；若不设置类目，将由系统进行类目预测，预测的类目结果可在Response中获取 。 对于布料、商标、通用搜索，不论是否设置类目，系统都会将类目设置为88888888。	否	可默认不选择。 说明 如果在上传图片过程中指定了类目，则在搜索过程中也要指定相同的类目进行检索，否则会出现原图搜不到原图的情况。
   返回结果数	返回相似结果的最大值。取值范围1~100。默认值为10。	否	10
   结果起始位置	返回相似结果的起始位置。取值范围0~499。默认值为0。	否	0
   过滤条件	搜索时可以设置过滤条件，只返回符合过滤条件的图像结果。例如只返回int_attr为22的图像结果，或者只返回str_attr为"top"的图像结果。 int_attr支持的操作符有>、>=、<、<=、=。 str_attr支持的操作符有=和!=。 多个条件之间支持AND和OR进行连接。 说明 具体使用方法请参考条件过滤	否	int_attr=22 AND str_attr="top"

   

2. 单击确认，进行相似图片搜索操作。

完成

5

清理及后续

5

清理

本教程使用的图像搜索实例，只能免费试用1个月，实例到期后将自动释放。完成教程后，您可以按照如下场景进行处理：

• 如果您不需要继续使用，请及时清理测试数据和使用资源，单击进入实例详情，单击清空图片。

  

• 如果您需要继续使用，请在实例到期前或到期后7天内进行续费操作，具体操作请参见续费实例。未续费的实例将在到期7天后被释放，释放后数据将被永久删除，无法恢复。

后续

您可以通过API查看更多接口和服务，详情请见API参考。也可以通过SDK访问和操作实例，详情请见SDK参考。