本文为您介绍目标检测(objectdet)类目下的着装检测DetectWorkwear的语法及示例。

功能描述

着装检测能力基于视觉AI算法、物联网、大数据分析技术,检测指定场景范围内的人员帽子、口罩、工作服等穿戴情况,对不规范穿戴行为进行实时预警。

说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

工作人员规范着装识别:检测餐厅(后厨、前场)、服务大厅、工地、工厂、油田等场景下的工作人员着装(衣服、帽子、口罩等)是否合规,针对不规范行为进行实时预警,并提醒进行相应整改。

特色优势

  • 识别准确:基于大量场景样本的基础上,对不同环境、光线、角度、目标状态等进行针对性的训练学习,算法模型识别精度高。
  • 适应性强:算法模型场景适应性强,可直接用于不同空间布局的场景、各类餐厅后厨及用餐前场。
  • 自研算法:通过多端多场景风险发现互通,形成检测、预警、整改、优化全链路闭环,结合数据分析、规则提取实现反哺生产,进而优化模型性能。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通目标检测服务,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入步骤:

  • SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为目标检测(objectdet)类目的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 示例代码:该能力常用语言的示例代码,请参见着装检测示例代码

7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

输入限制

  • 图像格式:JPG、JPEG、PNG、BMP。
  • 图像大小:不超过4 MB,长宽比建议为16:9。
  • 图像分辨率:大于1080×720像素。
  • URL地址中不能包含中文字符。
  • 推荐的图像和检测目标的分辨率如下表所示。

计费说明

关于着装检测的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DetectWorkwear

系统规定参数。取值:DetectWorkwear

Clothes Object

着装参数设置

MaxNum Long 1

设定最多识别多少人体。最大值为5。

Threshold double 0.4

设定阈值。取值范围0.0~1.0,数值越大,要求和样本数据相似度越高,默认0.4。

ImageUrl String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/tiyan/xxxx.jpg

图像URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理

Labels.N String hat

检测的属性,取值如下:

  • mask:口罩
  • hat:帽子
  • clothes:衣服

返回数据

名称 类型 示例值 描述
RequestId String 16CA8094-D7BC-51D4-8D55-6AC59AB20E0B

请求ID。

Data Object

返回的结果数据内容。

Elements Array of 识别内容

检测结果。

Property Array of 识别属性

检测结果属性。仅当Type返回0或1时,该字段显示返回结果,否则返回为空。

Label String hat

检测的属性。

Probability Object

检测概率数据。

No double 0.00036084422

确定未戴口罩、未穿工装、未戴帽子的概率。

Threshold Long 0

系统推荐的阈值。

Unknown double 0.0006906331

未知概率。

Yes double 0.9989485

确定戴口罩、穿工装、戴帽子的概率。

Rectangles Object

检测结果位置信息。

Height Long 96

高度,单位像素。

Left Long 1067

左上角Y坐标,单位像素。

Top Long 426

左上角X坐标,单位像素。

Width Long 88

宽度,单位像素。

Score double 0.63913465

检测结果概率值。

Type String 1

检测结果类型。取值如下:

  • 0:人体
  • 1:人头
  • 2:人脸
  • 3:手

SDK参考

阿里云视觉AI目标检测类目下的着装检测能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为目标检测(objectdet)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览

示例代码

该能力常用语言的示例代码,请参见着装检测示例代码

示例

请求示例

http(s)://objectdet.cn-shanghai.aliyuncs.com/?Action=DetectWorkwear              //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&Clothes={"MaxNum":1,"Threshold":0.4}
&ImageUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/tiyan/xxxx.jpg
&Labels=["hat"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetectWorkwearResponse>
    <RequestId>16CA8094-D7BC-51D4-8D55-6AC59AB20E0B</RequestId>
    <Data>
        <Elements>
            <Property>
                <Label>hat</Label>
                <Probability>
                    <No>0.00036084422</No>
                    <Threshold>0</Threshold>
                    <Unknown>0.0006906331</Unknown>
                    <Yes>0.9989485</Yes>
                </Probability>
            </Property>
            <Rectangles>
                <Height>96</Height>
                <Left>1067</Left>
                <Top>426</Top>
                <Width>88</Width>
            </Rectangles>
            <Score>0.63913465</Score>
            <Type>1</Type>
        </Elements>
    </Data>
</DetectWorkwearResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16CA8094-D7BC-51D4-8D55-6AC59AB20E0B",
  "Data" : {
    "Elements" : {
      "Property" : {
        "Label" : "hat",
        "Probability" : {
          "No" : 3.6084422E-4,
          "Threshold" : 0,
          "Unknown" : 6.906331E-4,
          "Yes" : 0.9989485
        }
      },
      "Rectangles" : {
        "Height" : 96,
        "Left" : 1067,
        "Top" : 426,
        "Width" : 88
      },
      "Score" : 0.63913465,
      "Type" : 1
    }
  }
}

错误码

关于着装检测的错误码,详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。