文档简介:
接口描述
该服务用于识别红酒标签,即对于输入的一张图片(可正常解码,长宽比适宜,且酒标清晰可见),输出图片中的红酒名称、国家、产区、酒庄、类型、糖分、葡萄品种、酒品描述等信息。可识别数十万中外常见红酒。
注意:图片中酒标要清晰可见,示例图片如下
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v1/redwine
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 说明 | |
---|---|---|---|---|
image | 和url二选一 | string | 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式。注意:图片需要base64编码、去掉编码头(data:image/jpg;base64,)后,再进行urlencode。 | |
url | 和image二选一 | string | 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效。 |
请求示例代码
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v1/redwine?access_token=
【调用鉴权接口获取的token】' --data 'image=【图片Base64编码,需UrlEncode】
' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 请求标识码,随机数,唯一 |
result | 是 | dict | 识别结果 |
+hasdetail | 是 | unit | 判断是否返回详细信息(除红酒中文名之外的其他字段),含有返回1,不含有返回0 |
+wineNameCn | 是 | string | 红酒中文名,无法识别返回空,示例:波斯塔瓦经典赤霞珠品丽珠半甜红葡萄酒 |
+wineNameEn | 否 | string | 红酒英文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:Bostavan Classic Cabernet |
+countryCn | 否 | string | 国家中文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:摩尔多瓦 |
+countryEn | 否 | string | 国家英文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:Moldova |
+regionCn | 否 | string | 产区中文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:波尔多 |
+regionEn | 否 | string | 产区英文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:Bordeaux |
+subRegionCn | 否 | string | 子产区中文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:梅多克 |
+subRegionEn | 否 | string | 子产区英文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:Medoc |
+wineryCn | 否 | string | 酒庄中文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:波斯塔瓦酒庄 |
+wineryEn | 否 | string | 酒庄英文名,hasdetail = 0时,表示无法识别,该字段不返回,示例:Vinaria Bostavan |
+classifyByColor | 否 | string | 酒类型,hasdetail = 0时,表示无法识别,该字段不返回,示例:红葡萄酒 |
+classifyBySugar | 否 | string | 糖分类型,hasdetail = 0时,表示无法识别,该字段不返回,示例:半甜型 |
+color | 否 | string | 色泽,hasdetail = 0时,表示无法识别,该字段不返回,示例:宝石红色 |
+grapeCn | 否 | string | 葡萄品种,可能有多种葡萄,hasdetail = 0时,表示无法识别,该字段不返回,示例:品丽珠;赤霞珠 |
+grapeEn | 否 | string |
葡萄品种英文名,可能有多种葡萄,hasdetail = 0时,表示无法识别,该字段不返回 ,示例:Cabernet Franc;Cabernet Sauvignon |
+tasteTemperature | 否 | string | 品尝温度,hasdetail = 0时,表示无法识别,该字段不返回,示例:6-11℃ |
+description | 否 | string |
酒品描述,hasdetail = 0时,表示无法识别,该字段不返回,示例:葡萄酒呈深宝石红色 ,具有香料、香草和新鲜水果的果香,酒体分明,口感畅顺,果香横溢,单宁软化程度高,让你回味无穷 |
返回示例
仅识别出红酒名称,hasdetail = 0:
{
"log_id": 3450013152046070669,
"result":
{
"wineNameCn": "银色高地阙歌干红",
"hasdetail":0
}
}
识别出详细信息,hasdetail = 1:
{ "log_id": 2495538539661269738, "result": { "classifyByColor": "红葡萄酒/Red Wine", "subRegionCn": "梅多克", "wineNameCn": "拉图嘉利庄园红葡萄酒(正牌)", "subRegionEn": "Medoc", "regionEn": "Bordeaux", "color": "深紫红色/Dark Violet", "wineNameEn": "Chateau La Tour Carnet", "hasdetail": 1, "wineryCn": "拉图嘉利庄园", "classifyBySugar": "干型/Dry", "tasteTemperature": "16-18℃", "regionCn": "波尔多", "wineryEn": "Chateau La Tour-Carnet", "grapeCn": "", "grapeEn": "", "countryCn": "法国", "countryEn": "France", "description": "此酒充满红果和黑果味道,并带有矿物质和花香(紫罗兰,玫瑰),
混合些许香草气息,单宁柔软,余香悠长。在口中留下清新的味道,香料和香草味道萦绕口中。" } }