文档中心

接口描述

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

注意：在正式使用之前，请先在控制台创建应用，并在产品服务/图像识别-应用列表/应用详情最下方建库后，自定义菜品识别下的所有子接口方可使用。

自定义菜品-入库

子接口说明

该接口实现单张菜品图片入库，入库时需要同步提交图片及可关联至本地菜品图库的摘要信息（具体变量为brief，brief可传入图片在本地标记id、图片url、图片名称等）

入库图片格式要求

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

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

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

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

5、入库图片是主菜图，为保证识别效果，入库图需沿着主菜四周裁剪图片进行入库，减少多于信息干扰。

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

Header如下：

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

请求参数

请求代码示例

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

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

curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v1/real

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

brief=1&image=【图片Base64编码，需UrlEncode】&sub_lib=[appid]' -H '

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

返回说明

返回参数

返回示例

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
}

自定义菜品-检索

子接口说明

在已自建菜品库并入库的情况下，该接口实现单菜品/多菜品的识别。

请求图片格式要求

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参数：

Header如下：

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

请求参数

请求代码示例

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

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

curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v1/realtime_

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

'image=【图片Base64编码，需UrlEncode】&sub_lib=[appid]' -H '

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

返回说明

返回参数

返回示例

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
}

自定义菜品-删除

子接口说明

该接口实现已入库菜品图片的删除操作。

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

Header如下：

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

请求参数

请求代码示例

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

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

curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classi

fy/v1/realtime_search/dish/delete?access_token=【调用鉴权接口获取的token】

' --data 'image=【图片Base64编码，需UrlEncode】&sub_lib=[appid]' -H '

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

返回说明

返回参数

返回示例

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
}