自定义红酒识别
所有文档

          图像识别

          自定义红酒识别

          申请邀测权限

          该接口正在邀测中,在正式使用之前,请先提交提交工单,提供公司名称、appid、应用场景,工作人员协助开通权限后方可使用

          接口描述

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

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

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

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

          自定义红酒-入库

          子接口说明

          该接口实现单张红酒图片入库,入库时需要同步提交图片及可关联至本地红酒图库的摘要信息(具体变量为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 和url二选一 string 图像数据,base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。注意要去掉图片头部,如(data:image/jpg;base64,)
          url 和image二选一 string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效。
          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 和url二选一 string - 图像数据,base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。注意要去掉图片头部,如(data:image/jpg;base64,)
          url 和image二选一 string - 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效。
          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,)
          url 和image二选一 string - 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效。
          brief false string - 更新的摘要信息,最长256B

          返回说明

          返回参数

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

          返回示例

          {
              "log_id": 2263663554
          }
          上一篇
          图像多主体检测
          下一篇
          SDK文档