开放能力
开发平台
行业应用
生态合作
开发与教学
资讯 社区 控制台
技术能力
语音技术
图像技术
文字识别
人脸与人体识别
视频技术
AR与VR
自然语言处理
知识图谱
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
智能农业
信息服务
智能园区
智能硬件
图像识别

    自定义红酒识别

    申请邀测权限

    该接口正在邀测中,在正式使用之前,请先提交提交工单,提供公司名称、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文档