自定义红酒识别（邀测）

更新时间：2024-02-04

该接口已停止更新且即将下线，为避免影响您的业务使用，请及时进行相关迁移工作

接口描述

支持自建红酒图库，入库相关红酒信息资料，通过接口参数可自由选择返回百度公库或者自定义子库的红酒结果

自定义红酒识别服务包括四个子接口：入库、检索、删除、更新

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

上传图片中的酒标要清晰可见，示例图片如下

自定义红酒-入库

子接口说明

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

入库图片格式要求

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

2、入库图为单个红酒图

3、入库的单个红酒图的背景尽可能和实际场景(比如桌面)需要识别的场景相似

4、为实现较好的识别效果，单个红酒图可多入库几张（不同角度、光线等情况下的图片）

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

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

Header如下：

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

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

请求参数

参数	是否必选	类型	说明
image	true	string	图像数据，base64编码后大小不超过4M，最短边至少50px，最长边最大4096px，支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误，提示不能重复入库。注意要去掉图片头部，如（data:image/jpg;base64,）
brief	true	string	红酒名称摘要信息，检索时带回，不超过256B。由于检索后需要与本地数据库关联，建议brief可传入图片在本地标记id、图片url、图片名称等

返回说明

返回参数

字段	是否必选	类型	说明
log_id	否	uint64	唯一的log id，用于问题定位
cont_sign	否	string	上传图片的签名信息，请务必保存至本地，以便后续用作批量删除、查询某张图是否已经入过库等用途

返回示例

{
    "cont_sign": "222,333",
    "log_id": 1837888624
}

自定义红酒-检索

子接口说明

在已自建红酒库并入库的情况下，该接口实现红酒的识别

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

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

Header如下：

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

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

请求参数

参数	是否必选	类型	可选值范围	说明
image	true	string	-	图像数据，base64编码后大小不超过4M，最短边至少50px，最长边最大4096px，支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误，提示不能重复入库。注意要去掉图片头部，如（data:image/jpg;base64,）
custom_lib	true	string	0/1/2	选择检索的图片库 0：默认只检索公库 1：只检索自定义子库 2：检索公库+自定义子库

返回说明

返回参数

字段	是否必选	类型	说明
log_id	true	uint64	唯一的log id，用于问题定位
result_num	true	uint32	检索结果数（包含公库的结果+子库的结果）
result	true	array[]	识别结果数组
+res_custom	false	array[]	子库返回的结果数组
++cont_sign	false	string	图片签名，可以用来删除图片或定位问题
++score	false	float	图片相关性，取值范围0-1，越接近1代表越相似
++brief	false	string	入库红酒图片时添加的brief信息
+res_public	false	array[]	子库返回的结果数组
++hasdetail	false	unit	判断是否返回详细信息（除红酒中文名之外的其他字段），含有返回1，不含有返回0
++wineNameCn	false	string	红酒中文名，无法识别返回空，示例：波斯塔瓦经典赤霞珠品丽珠半甜红葡萄酒
++wineNameEn	false	string	红酒英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Bostavan Classic Cabernet
++countryCn	false	string	国家中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：摩尔多瓦
++countryEn	false	string	国家英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Moldova
++regionCn	false	string	产区中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：波尔多
++regionEn	false	string	产区英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Bordeaux
++subRegionCn	false	string	子产区中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：梅多克
++subRegionEn	false	string	子产区英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Medoc
++wineryCn	false	string	酒庄中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：波斯塔瓦酒庄
++wineryEn	false	string	酒庄英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Vinaria Bostavan
++classifyByColor	false	string	酒类型，hasdetail = 0时，表示无法识别，该字段不返回，示例：红葡萄酒
++classifyBySugar	false	string	糖分类型，hasdetail = 0时，表示无法识别，该字段不返回，示例：半甜型
++color	false	string	色泽，hasdetail = 0时，表示无法识别，该字段不返回，示例：宝石红色
++grapeCn	false	string	葡萄品种，可能有多种葡萄，hasdetail = 0时，表示无法识别，该字段不返回，示例：品丽珠;赤霞珠
++grapeEn	false	string	葡萄品种英文名，可能有多种葡萄，hasdetail = 0时，表示无法识别，该字段不返回，示例：Cabernet Franc;Cabernet Sauvignon
++tasteTemperature	false	string	品尝温度，hasdetail = 0时，表示无法识别，该字段不返回，示例：6-11℃
++description	false	string	酒品描述，hasdetail = 0时，表示无法识别，该字段不返回，示例：葡萄酒呈深宝石红色，具有香料、香草和新鲜水果的果香，酒体分明，口感畅顺，果香横溢，单宁软化程度高，让你回味无穷

返回示例

  {
    "result": {
        "res_public": {
            "countryEn": "Chile",
            "grapeEn": "",
            "grapeCn": "",
            "color": "深紫红色/Dark Violet",
            "regionCn": "中央谷地",
            "regionEn": "Central Valley",
            "subRegionEn": "Colchagua Valley",
            "description": "此酒呈深紫红色，散发黑果风味及带点凉爽地区马齐古的凯奈尔的辛辣轻快果香，亦有小味儿多的强烈黑浆果味的香气，酒体丰厚，大量成熟的单宁赋予收敛感并令酒体结构更佳。",
            "subRegionCn": "空加瓜谷",
            "wineryEn": "Montes Wines",
            "classifyByColor": "红葡萄酒/Red Wine",
            "wineryCn": "蒙特斯酒庄",
            "wineNameCn": "蒙特斯紫天使红葡萄酒",
            "classifyBySugar": "干型/Dry",
            "wineNameEn": "Montes Purple Angel",
            "tasteTemperature": "14-18℃",
            "hasdetail": 1,
            "countryCn": "智利"
        },
        "res_custom": [
            {
                "brief": "今年新品-蒙特斯紫天使红葡萄酒",
                "score": 0.9974775525392304,
                "cont_sign": "206819727,1345811003"
            }
        ]
    },
    "log_id": 1324262041652822016,
    "result_num": 2
}

自定义红酒-删除

子接口说明

该接口实现已入库红酒图片的删除操作

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

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

Header如下：

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

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

请求参数

参数	是否必选	类型	可选值范围	说明
image	false	string	-	图像数据，base64编码后大小不超过4M，最短边至少50px，最长边最大4096px，支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误，提示不能重复入库。注意要去掉图片头部，如（data:image/jpg;base64,）
cont_sign_list	false	string	-	图片签名（和image二选一），支持批量删除，批量删除时请勿传image，最多支持50个cont_sign列表，样例："932301884,1068006219;316336521,553141152"

返回说明

返回参数

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

返回示例

{
    "log_id": 1837888624
}

自定义红酒—更新

子接口说明

更新图库中图片的摘要brief信息

在线调试

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

请求说明

请求示例

HTTP 方法：POST

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

URL参数：

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

Header如下：

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

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

请求参数

参数	是否必选	类型	可选值范围	说明
image	和url二选一	string	-	图像数据，base64编码后大小不超过4M，最短边至少50px，最长边最大4096px，支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误，提示不能重复入库。注意要去掉图片头部，如（data:image/jpg;base64,）
brief	是	string	-	更新的摘要信息，最长256B

返回说明

返回参数

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

返回示例

{
    "log_id": 2263663554
}

红酒识别