Hi，您好，欢迎使用百度图像搜索API服务。

本文档主要针对API开发者，描述百度以图搜图接口服务的相关技术内容。如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

• 在百度云控制台内提交工单；进入AI社区交流；提交合作咨询
• 具有免费调用额度的接口，超过免费额度后会返回错误码 17（每天请求量超限额：Open api daily request limit reached ），或者错误码 19（请求总量超限额：Open api total request limit reached）
• 未上线计费的接口，可通过QQ群（1067276154）联系群管、或提交工单申请提额；已上线计费的接口，请直接在控制台开通计费、或者购买次数包，调用量不受限制，按调用次数计费，并保证10qps的并发**

产品功能简述

服务名称	能力简要描述
相同图片搜索	在自建图库中找到与检索图相同的图片，支持找到局部内容相同的大图，或适度调整背景和角度的相同图片；可用于图片精确查找、重复图片过滤等场景。
相似图片搜索	在自建图库中找到与检索图片语义相似的图片集，并给出相似度打分（综合图片类型、颜色、内容、布局等特征）；适用于各种相似图片查找、相关内容推荐场景。
商品图片搜索	针对商品类图片，专项训练检索模型，在自建图库中搜索相同及相似的商品图片集，可找到不同颜色、背景、角度的同款商品；适用于电商平台拍照搜商品、相关商品推荐等场景。
绘本图片搜索	可在自建图库中找到与检索图相同的绘本图片、儿童书本教材。支持用局部绘本页，找到内容相同的大图；可用于绘本、图书、教材的精确查找、重复图片过滤等场景。
面料图片搜索	可在自建图库中找到与检索图相同或相似花纹的家纺布料、瓷砖板材。；可用于布料、瓷砖、板材商品的设计查找及素材管理等场景。

应用选型方案

1、 什么时候使用相同图片搜索？

• 典型应用场景：图片去重、图片精确查找，如图片类站点对海量库存图片进行查重过滤
• 适用的图片类型：各种网络图片、实拍图均可；注意检索图和入库的原图要保持场景一致性，比如入库的原图为标准的广告图（无背景干扰），则检索图要尽量避免背景、其他干扰特征，否则模型计算图片的相似度时会有噪声，造成检索结果不准确。

举个例子：小张入库了5万张海报设计图，都是标准的电子版海报图片，无任何背景干扰；在线下活动时，要根据手机拍摄的海报图片判断是不是跟图库里的设计图重复了，手机实拍时要避免拍到海报图片之外的物体（如墙上的装饰、参加活动的人等各种背景元素），同时要拍到海报的全部或者大部分主体内容，不能只拍到一个海报的小角落就去检索，以免影响检索效果。

2、 什么时候使用相似图片搜索？

• 典型应用场景：找相似的图片集合（返回的结果包含相同的图片），各种设计素材、美术作品、UGC内容等
• 适用的图片类型：各种网络图片、实拍图均可；注意检索图和入库的原图要尽量保持场景一致性，比如入库的原图为标准的广告图（无背景干扰），则检索图要尽量避免背景、其他干扰特征，否则模型计算图片的相似度时会有噪声，造成检索结果不准确。

3、 什么时候使用商品图片搜索？

• 典型应用场景：各类B2B、B2C电商平台，相似商品推荐、拍照搜同款或者相似商品
• 适用的图片类型：电商商品图片（实体商品为主，如数码3C、服装鞋帽、日化百货等）

注意：部分特殊商品，如面料、木材、瓷砖等，建议同步对比测试相似图搜索的效果，择优使用。

4、 什么时候使用绘本图片搜索？

• 典型应用场景：进行儿童绘本、教材书本的“拍照搜书”，儿童通过学习机、pad等设备拍摄绘本、书本的照片，在学习库中自动检索出对应的封面或者书页，实现绘本跟读、教材讲解等功能
• 适用的图片类型：各种网络图片、实拍图均可

图库管理说明

1、百度相同图搜索/相似图搜索/商品图搜索/绘本图搜索API服务支持开发者基于自建图片库进行入库、检索、删除、更新操作。开发者在控制台创建应用后，需要在控制台-应用详情页 申请建库，建库成功后相关接口能力可正常调用。

2、申请建库时，图库的图片数量上限为50万，避免浪费资源；如果容量不够用，可在控制台-应用详情页 申请扩容，工作人员会在1-3个工作日内审批，每次扩容的申请上限也是50万，可以反复申请扩容，原则上图库总量无上限，百万级、千万级、甚至亿级的图片量都可以做到实时检索，秒级返回检索结果。

3、图像搜索控制台的图库管理功能，支持对图库里的图片进行可视化管理，可小批量上传图片、预览大图、修改摘要和分类信息、删除图片，入口在控制台-应用详情页 管理图库，注：大批量上传、修改、删除请调用API。

同时，图库管理后台支持在线测试检索效果，点击右上角搜索框边上的“相机”标识，可以上传图片，测试检索效果。注：相似图片搜索、商品图片搜索的在线测试默认返回相关性Top 50的结果图，如果图库里不满50张图，则全部返回。

注：若图库超过1年未使用（无入库、检索等操作），平台将对相关图库资源进行释放。

接口请求格式

POST方式调用

注意：Content-Type为application/x-www-form-urlencoded，然后通过urlencode格式化请求体。

接口返回格式

JSON格式

接口请求限制

请求图片需经过base64编码：图片的base64编码指将一副图片数据编码成一串字符串，使用该字符串代替图像地址。您可以首先得到图片的二进制，然后用Base64格式编码即可。注意在请求时需去掉头部。

注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）

请求格式支持：PNG、JPG、JPEG、BMP

接口名称	图片编码后大小限额
相同图片搜索	图像数据base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。最短边至少50px，最长边最大4096px
相似图片搜索	图像数据base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。最短边至少50px，最长边最大4096px
商品图片搜索	图像数据base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。最短边至少300px，最长边最大4096px
绘本图片搜索	图像数据base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。最短边至少150px，最长边最大4096px