最近更新时间:2021-03-12
1 功能描述
通过图像分类识别技术,识别出图片内是什么物体,一张图返回一个最大概率的结果,包含2万类的物体标签。
调用地址:https://apim.unicloud.com/api/image/generalobject/1.0.0/
请求方式:POST
返回类型:JSON
Header如下:
| 参数 | 值 | 说明 |
|---|---|---|
| Content-Type | multipart/form-data | -- |
| Authorization | Bearer | 参考Token获取 |
Body如下:
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | true | string or file | - | 1、支持传图片URL或者直接post图片文件,不过两者不能混在同一请求中 2、只支持对静态图像的处理,如:png、jpg、jpeg、tif、webp,不支持动态图像的处理,如:gif 3、图片大小必须在1M以内,且建议对图片进行压缩处理,等比压缩到[256, 512]之间 |
注:Body是form-data格式
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/
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/
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/
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 返回结果数据 |
| +rate | float | 检测出来物体相似度,范围在[0-1]之间,分值越高,越相似 |
| +label | int | 检测出来的物体标签 |
| +label_chinese | string | 检测出来的物体标签对应中文 |
| +label_english | string | 检测出来的物体标签对应英文 |
| +root | string | 检测出来的物体类别 |
| +labels | array | 标签结果数组,标签对应中英文请见通用物体识别标签列表 |
| +rates | array | 相似度结果数组 |
| code | int | 返回码 |
| message | string | 返回信息 |
{
"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"
}{
"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"
}