简介
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 |