百度智能云图像识别API文档 - 菜品识别
文档简介:
接口描述:
该请求用于菜品识别。即对于输入的一张图片(可正常解码,且长宽比适宜),输出图片的菜品名称、卡路里信息、置信度。
在线调试:
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
【百度智能云】图像识别
接口描述
该请求用于菜品识别。即对于输入的一张图片(可正常解码,且长宽比适宜),输出图片的菜品名称、卡路里信息、置信度。
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v2/dish
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字段失效。 | |
top_num | 否 | unit32 | 返回结果top n,默认5. | |
filter_threshold | 否 | float | 默认0.95,可以通过该参数调节识别效果,降低非菜识别率. | |
baike_num | 否 | integer | 用于控制返回结果是否带有百科信息,若不输入此参数,则默认不返回百科结果;若输入此参数,会根据输入的整数返回相应个数的百科信息 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v2/dish?access
_token=【调用鉴权接口获取的token】' --data 'image=【图片Base64编码,需UrlEncode
】&top_num=5' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
result_num | 否 | unit32 | 返回结果数目,及result数组中的元素个数 |
result | 否 | array() | 菜品识别结果数组 |
+name | 否 | string | 菜名,示例:鱼香肉丝 |
+calorie | 否 | float | 卡路里,每100g的卡路里含量 |
+probability | 否 | float | 识别结果中每一行的置信度值,0-1 |
+baike_info | 否 | object | 对应识别结果的百科词条名称 |
++baike_url | 否 | string | 对应识别结果百度百科页面链接 |
++image_url | 否 | string | 对应识别结果百科图片链接 |
++description | 否 | 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 { "log_id": 7357081719365269362, "result_num": 5, "result": [ { "calorie": "119", "has_calorie": true, "name": "酸汤鱼", "probability": "0.396031" "baike_info": { "baike_url": "http://baike.baidu.com/item/%E9%85%B8%E6%B1%A4%E9%B1%BC/1754055", "description": "酸汤鱼,是黔桂湘交界地区的一道侗族名菜,与侗族相邻的苗、
水、瑶等少数民族也有相似菜肴,但其中以贵州侗族酸汤鱼最为有名,据考证此菜肴最早源于黎平县雷洞镇牙双一带。
制作原料主要有鱼肉、酸汤、山仓子等香料。成菜后,略带酸味、幽香沁人、鲜嫩爽口开胃,是贵州“黔系”
菜肴的代表作之一。这道菜通常先自制酸汤,之后将活鱼去掉内脏,入酸汤煮制。" } }, { "calorie": "38", "has_calorie": true, "name": "原味黑鱼煲", "probability": "0.265432", }, { "calorie": "144", "has_calorie": true, "name": "椒鱼片", "probability": "0.0998993" }, { "calorie": "98", "has_calorie": true, "name": "酸菜鱼", "probability": "0.0701917" }, { "calorie": "257.65", "has_calorie": true, "name": "柠檬鱼", "probability": "0.0471465" }] }