文档中心

产品使用说明

可在自建图库中找到与检索图相同的绘本图片、儿童书本教材。支持用局部绘本页，找到内容相同的大图；可用于绘本、图书、教材的精确查找、重复图片过滤等场景。

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

绘本图片搜索包含入库、检索、删除、更新4个子接口；在正式使用之前请在控制台创建应用后，在应用详情页申请建库，建库成功后方可正常使用入库、检索、删除、更新接口。

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

绘本图片搜索—入库

在线调试

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

该接口实现单张图片入库，入库时需要同步提交图片及可关联至本地图库的摘要信息（具体变量为brief，具体可传入图片在本地标记id、图片url、图片名称等）；同时可提交分类维度信息（具体变量为tags，最多可传入2个tag），方便对图库中的图片进行管理、分类检索。

注：重复添加完全相同的图片会返回错误。

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

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

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/imagesearch/v1/realtime_search/picturebook/add

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

# 绘本图片搜索—入库 curl -i -k 'https://aip.baidubce.com/rest/2.0/imagesearch/v1/real

time_search/picturebook/add?access_token=【调用鉴权接口获取的token】' --data 'brief

={"name":"小度", "id":"1"}&image=【图片Base64编码，需UrlEncode】&tags=1,1' -H 'Content

-Type:application/x-www-form-urlencoded'

返回说明

返回参数

返回示例

{ "log_id": 2263663554, "cont_sign": "4261577168,501945506" }

入库之后的图片，可在控制台的图库管理后台进行可视化管理，支持预览大图、更新摘要、更新分类信息、删除图片，入口在控制台-应用详情页 管理图库

• 注：大批量更新图片摘要/分类、删除图片请调用API。

同时，图库管理后台支持在线测试检索效果，点击右上角搜索框边上的“相机”标识，可以上传图片，测试检索效果。

绘本图片搜索—检索

在线调试

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

完成入库后，可使用该接口实现绘本图检索。支持传入指定分类维度（具体变量tags）进行检索，返回结果支持翻页（具体变量pn、rn）。

注意：检索接口不返回原图，仅反馈当前填写的brief信息，请调用入库接口时尽量填写可关联至本地图库的图片id或者图片url等信息。

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

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

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/imagesearch/v1/realtime_search/picturebook/search

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

# 绘本图片搜索—检索 curl -i -k 'https://aip.baidubce.com/rest/2.0/imagesearch/v1/

realtime_search/picturebook/search?access_token=【调用鉴权接口获取的token】' --data 

'image=【图片Base64编码，需UrlEncode】&pn=200&rn=100' -H 'Content-Type:application/x-www-form-urlencoded'

返回说明

返回参数

返回示例

{ "result_num": 1, "result": [ { "score": 0.97976700290421, "brief": "./data/jay1.jpg",

 "cont_sign": "475124309,1080176642" } ], "has_more": "false", "log_id": 1968648150 }

绘本图片搜索—删除

在线调试

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

删除图库中的图片，支持批量删除，批量删除时请传cont_sign参数，勿传image、url，最多支持100个cont_sign。

图片删除延时生效，每天数据库定时更新进行物理删除，刚删除时仍然可以在图库中检索到（但图库管理后台是同步清除），请过一段时间再验证，一般最多延时4小时左右。

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

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

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/imagesearch/v1/realtime_search/picturebook/delete

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

# 绘本图片搜索—删除 curl -i -k ' https://aip.baidubce.com/rest/2.0/imagesearch/v1

/realtime_search/picturebook/delete?access_token=【调用鉴权接口获取的token】' --data

 'image=【图片Base64编码，需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'

返回说明

返回参数

返回示例

{ "log_id": 50488417 }

绘本图片搜索—更新

在线调试

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

更新图库中图片的摘要和分类信息（具体变量为brief、tags）

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

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

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/imagesearch/v1/realtime_search/picturebook/update

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

# 绘本图片搜索—更新 curl -i -k 'https://aip.baidubce.com/rest/2.0/imagesearch/v1/r

altime_search/picturebook/update?access_token=【调用鉴权接口获取的token】' --data 

'brief={"name":"小度2", "id":"2"}&image=【图片Base64编码，需UrlEncode】&tags=2,2'

 -H 'Content-Type:application/x-www-form-urlencoded'

返回说明

返回参数

返回示例

{ "log_id": 2263663554 }