垃圾分类识别
本文介绍图像识别(imagerecog)类目下的垃圾分类识别ClassifyingRubbish的语法及示例。
功能描述
垃圾分类识别能力可以对图片中的物品垃圾进行分类,并给出具体的物品名称。
接入指引
1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
2. 开通能力:请确保您已开通图像识别服务,若未开通服务请立即开通。
3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权。
4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。
5. 开发接入步骤:
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为图像识别(imagerecog)的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码:该能力常用语言的示例代码,请参见垃圾分类识别示例代码。
7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像类型:JPEG、JPG、PNG。
- 图像大小:不大于3 MB。
- 图像分辨率:不限制图像分辨率,但图像分辨率太高可能会导致API识别超时,超时时间为5秒。
- URL地址中不能包含中文字符。
计费说明
垃圾分类识别能力目前处于公测期,可免费调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | ClassifyingRubbish | 系统规定参数。取值:ClassifyingRubbish。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/ClassifyingRubbish/ClassifyingRubbish6.jpg | 图像URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 1619647E-92ED-5641-A1D9-F05C33FD294A | 请求ID。 |
Data | Object | 返回的结果数据内容。 |
|
Sensitive | Boolean | false | 图片中是否存在敏感信息。
|
Elements | Array of Element | 输出垃圾识别结果。 |
|
CategoryScore | Float | 0.9406 | 识别出的垃圾类别的置信度。 |
Rubbish | String | 纸板箱 | 具体的物品名称。 |
RubbishScore | Float | 0.9406 | 物品名称的置信度。 |
Category | String | 可回收垃圾 | 垃圾类别。包括可回收垃圾、干垃圾、湿垃圾、有害垃圾。 |
常见垃圾输出列举值
-
可回收物
废纸张:纸板箱、报纸、废弃书本、快递纸袋、打印纸、信封、广告单、纸塑铝复合包装(利乐包)。
废塑料:食品与日用品塑料瓶罐及瓶盖(饮料瓶、奶瓶、洗发水瓶、乳液罐)、食用油桶、塑料碗(盆)、塑料盒子(食品保鲜盒、收纳盒)、塑料玩具(塑料积木、塑料模型)、塑料衣架、施工安全帽、PE塑料、pvc、亚克力板、塑料卡片、密胺餐具、kt板、泡沫(泡沫塑料、水果网套)。
废玻璃制品:食品及日用品玻璃瓶罐(调料瓶、酒瓶、化妆品瓶)、玻璃杯、窗玻璃、玻璃制品(放大镜、玻璃摆件)、碎玻璃。
废金属:金属瓶罐(易拉罐、食品罐/桶)、金属厨具(菜刀、锅)、金属工具(刀片、指甲剪、螺丝刀)、金属制品(铁钉、铁皮、铝箔)。
废织物:旧衣服、床单、枕头、棉被、皮鞋、毛绒玩具(布偶)、棉袄、包、皮带、丝绸制品。
其它:电路板(主板、内存条)、充电宝、电线、插头、木制品(积木、砧板)。
-
有害垃圾
废镍镉电池和废氧化汞电池:充电电池、镉镍电池、铅酸电池、蓄电池、纽扣电池。
废荧光灯管:荧光(日光)灯管、卤素灯。
废药品及其包装物:过期药物、药物胶囊、药片、药品内包装。
废油漆和溶剂及其包装物:废油漆桶、染发剂壳、过期的指甲油、洗甲水。
废矿物油及其包装物。
废含汞温度计、废含汞血压计:水银血压计、水银体温计、水银温度计。
废杀虫剂及其包装:老鼠药(毒鼠强)、杀虫喷雾罐。
废胶片及废相纸:x光片等感光胶片、相片底片。
-
厨余垃圾(湿垃圾)
食材废料:谷物及其加工食品(米、米饭、面、面包、豆类)、肉蛋及其加工食品(鸡、鸭、猪、牛、羊肉、蛋、动物内脏、腊肉、午餐肉、蛋壳)、水产及其加工食品(鱼、鱼鳞、虾、虾壳、鱿鱼)、蔬菜(绿叶菜、根茎蔬菜、菌菇)、调料、酱料。
剩菜剩饭:火锅汤底(沥干后的固体废弃物)、鱼骨、碎骨、茶叶渣、咖啡渣。
过期食品:糕饼、糖果、风干食品(肉干、红枣、中药材)、粉末类食品(冲泡饮料、面粉)、宠物饲料。
瓜皮果核:水果果肉(椰子肉)、水果果皮(西瓜皮、桔子皮、苹果皮)、水果茎枝(葡萄枝)、果实(西瓜籽)。
花卉植物:家养绿植、花卉、花瓣、枝叶。
中药药渣。
-
其他垃圾(干垃圾)
餐巾纸、卫生间用纸、尿不湿、猫砂、狗尿垫、污损纸张、烟蒂、干燥剂、污损塑料、尼龙制品、编织袋、防碎气泡膜、大骨头、硬贝壳、硬果壳(椰子壳、榴莲壳、核桃壳、玉米衣、甘蔗皮)、硬果实(榴莲核、菠萝蜜核)、毛发、灰土、炉渣、橡皮泥、太空沙、带胶制品(胶水、胶带)、花盆、毛巾、一次性餐具、镜子、陶瓷制品、竹制品(竹篮、竹筷、牙签)、成分复杂的制品(伞、笔、眼镜、打火机)。
SDK参考
阿里云视觉AI图像识别类目下的垃圾分类识别能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为图像识别(imagerecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例代码
该能力常用语言的示例代码,请参见垃圾分类识别示例代码。
示例
请求示例
http(s)://imagerecog.cn-shanghai.aliyuncs.com/?Action=ClassifyingRubbish //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/ClassifyingRubbish/ClassifyingRubbish6.jpg
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ClassifyingRubbishResponse>
<RequestId>1619647E-92ED-5641-A1D9-F05C33FD294A</RequestId>
<Data>
<Sensitive>false</Sensitive>
<Elements>
<Rubbish>纸板箱</Rubbish>
<Category>可回收垃圾</Category>
<CategoryScore>0.9406</CategoryScore>
<RubbishScore>0.9406</RubbishScore>
</Elements>
</Data>
</ClassifyingRubbishResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "1619647E-92ED-5641-A1D9-F05C33FD294A",
"Data" : {
"Sensitive" : false,
"Elements" : {
"Rubbish" : "纸板箱",
"Category" : "可回收垃圾",
"CategoryScore" : 0.9406,
"RubbishScore" : 0.9406
}
}
}
错误码
关于垃圾分类识别的错误码,详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。