图像搜索

    简介

    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张图,则全部返回。

    接口请求格式

    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
    下一篇
    接口调用方式