调用ClassifyingRubbish进行垃圾分类识别_视觉智能开放平台-阿里云帮助中心

功能描述

垃圾分类识别能力可以对图片中的物品垃圾进行分类，并给出具体的物品名称。

说明

您可以进入在线咨询获取在线人工帮助。
当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

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	图片中是否存在敏感信息。 true：存在敏感信息，不会返回具体垃圾分类信息。 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小时后会被系统自动清理删除。