细粒度图像识别——自定义菜品识别

接口描述

该请求用于入库自定义的单菜品图,实现上传多菜品图的精准识别,返回具体的菜名、位置、置信度信息 。自定义菜品识别包括三个子接口:单菜品入库、菜品检索、菜品删除。

注意:在正式使用之前,请前往细粒度图像识别页面提交合作咨询,或者申请加入百度图像识别官方QQ群(群号:659268104),提供公司名称、appid、应用场景、所需要入库的图片量,工作人员将协助建库。注意,工作人员协助建库后以下所有子接口方可使用

自定义菜品-入库

子接口说明

该接口实现单张菜品图片入库,入库时需要同步提交图片及可关联至本地菜品图库的摘要信息(具体变量为brief,brief可传入图片在本地标记id、图片url、图片名称等)
注意:在正式使用之前,请前往细粒度图像识别页面提交合作咨询,或者申请加入百度图像识别官方QQ群(群号:659268104),提供公司名称、appid、应用场景、所需要入库的图片量,工作人员将协助开通调用求权限。注意,工作人员协助开通权限后该接口方可使用

入库图片格式要求

1、base64编码不超过4M,图片长宽不限,建议长宽范围300pixel~3000pixel, 建议长宽比3:1之内,图片格式为通用的jpg、jpeg、png、bmp。

2、入库图为单个菜品图,如果检测出多菜或者0个菜,则无法入库。

3、入库的单个菜品图的背景尽可能和实际场景(比如餐厅)需要识别的场景相似,如快餐店自助结算的场景,建议拍摄【单个菜在餐盘中】之类的图片。

4、为实现较好的识别效果,单个菜品图尽量入库多张(不同摆盘、不同光线等情况下的图片),越多识别准确率越高。

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v1/realtime_search/dish/add

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - Base64编码字符串,以图片文件形式请求时必填。(支持图片格式:jpg,bmp,png,jpeg),图片大小不超过4M。最短边至少300px,最长边最大3000px。注意:图片需要base64编码、去掉编码头后再进行urlencode。
brief unit32 - 菜品名称摘要信息,检索时带回,不超过256B。由于检索后需要与本地数据库关联,建议brief可传入图片在本地标记id、图片url、图片名称等
sub_lib string - 默认传appid

请求代码示例

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

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

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
cont_sign string 输入图片签名

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
    "cont_sign": "222,333",
    "log_id": 1837888624
}

自定义菜品-检索

子接口说明

在已自建菜品库并入库的情况下,该接口实现单菜品/多菜品的识别。
注意:在正式使用之前,请前往细粒度图像识别页面提交合作咨询,或者申请加入百度图像识别官方QQ群(群号:659268104),提供公司名称、appid、应用场景、所需要入库的图片量,工作人员将协助开通调用求权限。注意,工作人员协助开通权限后该接口方可使用

请求图片格式要求

base64编码不超过4M,图片长宽不限,建议长宽范围300pixel~3000pixel, 建议长宽比3:1之内,图片格式为通用的jpg、jpeg、png、bmp。

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v1/realtime_search/dish/search

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - Base64编码字符串,以图片文件形式请求时必填。(支持图片格式:jpg,bmp,png,jpeg),图片大小不超过4M。最短边至少300px,最长边最大3000px。注意:图片需要base64编码、去掉编码头后再进行urlencode。
sub_lib string - 默认传appid

请求代码示例

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

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

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
result_num uint32 检索结果数
result object[] 识别结果数组
+location object 菜品在图片中的位置
++left int 水平坐标(左上角原点)
++top int 垂直坐标(左上角原点)
++width int 宽度
++height int 高度
+dishes object[] 识别结果数组
++cont_sign string 图片签名,可以用来删除图片或问题定位
++score float 图片相关性,0-1
++brief string 入库菜品时添加的brief信息

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
    "result_num": 2,
    "result": [
        {
            "location": {
                "left": 127,
                "top": 70,
                "width": 103,
                "height": 101
            },
            "dishes": [
                {
                    "score": 0.47976872324944,
                    "brief": "{\"name\":\"baicai\",\"id\":333}",
                    "cont_sign": "475124309,1080176642"
                }
            ]
        },
        {
            "location": {
                "left": 312,
                "top": 163,
                "width": 78,
                "height": 79
            },
            "dishes": [
                {
                    "score": 0.013810452073812,
                    "brief": "{\"name\":\"doufu\",\"id\":333}",
                    "cont_sign": "475124309,1080176642"
                }
            ]
        }
    ],
    "log_id": 1837888624
}

自定义菜品-删除

子接口说明

该接口实现已入库菜品图片的删除操作。
注意:在正式使用之前,请前往细粒度图像识别页面提交合作咨询,或者申请加入百度图像识别官方QQ群(群号:659268104),提供公司名称、appid、应用场景、所需要入库的图片量,工作人员将协助开通调用求权限。注意,工作人员协助开通权限后该接口方可使用

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v1/realtime_search/dish/delete

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - Base64编码字符串(和cont_sign二选一),以图片文件形式请求时必填。(支持图片格式:jpg,bmp,png,jpeg),图片大小不超过4M。最短边至少300px,最长边最大3000px。注意:图片需要base64编码、去掉编码头后再进行urlencode。
cont_sign string - 图片签名(和image二选一,image优先级更高)
sub_lib string - 默认传appid

请求代码示例

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

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

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
    "log_id": 1837888624
}