文档中心 > 通用物体识别
通用物体识别

最近更新时间:2021-03-12


1 功能描述

通过图像分类识别技术,识别出图片内是什么物体,一张图返回一个最大概率的结果,包含2万类的物体标签。

2 请求说明

2.1 请求方式

调用地址:https://apim.unicloud.com/api/image/generalobject/1.0.0/

请求方式:POST

返回类型:JSON

2.2 请求参数

Header如下:

参数说明
Content-Typemultipart/form-data--
AuthorizationBearer参考Token获取

Body如下:

参数是否必选类型可选值范围说明
imagetruestring or file-1、支持传图片URL或者直接post图片文件,不过两者不能混在同一请求中
2、只支持对静态图像的处理,如:png、jpg、jpeg、tif、webp,不支持动态图像的处理,如:gif
3、图片大小必须在1M以内,且建议对图片进行压缩处理,等比压缩到[256, 512]之间

注:Body是form-data格式

2.3 请求示例

curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \
-F 'image=@image_or_url' \
https://apim.unicloud.com/api/image/generalobject/1.0.0/

3 返回说明

3.1 返回参数

字段类型说明
dataobject返回结果数据
+ratefloat检测出来物体相似度,范围在[0-1]之间,分值越高,越相似
+labelint检测出来的物体标签
+label_chinesestring检测出来的物体标签对应中文
+label_englishstring检测出来的物体标签对应英文
+rootstring检测出来的物体类别
+labelsarray标签结果数组,标签对应中英文请见通用物体识别标签列表
+ratesarray相似度结果数组
codeint返回码
messagestring返回信息

3.2 返回示例

{    
    "data": {        
        "rate": 0.3166828453540802,        
        "label": 2352,        
        "label_chinese": "桌子",        
        "label_english": "table",        
        "root": "用品",        
        "rates": [0.3166828453540802,0.2931687831878662,0.17332641780376434,0.12941449880599976,0.04456445202231407],        
        "labels": [2352, 2586, 2592, 870, 13906]        
    },    
    "code": 0,    
    "message": "success"
}