创建云上工服工帽检测作业

功能介绍

该API可分析视频流。提供了工服和工帽的检测功能。根据用户配置进行工服工帽检测，当有人未穿工服或未戴工帽，会上报事件信息。

• 视频编码格式支持H264或者H265。

调试

您可以在API Explorer中调试该接口。

URI

• URI格式

  POST /v2/{project_id}/services/c-safetysuitedetection-cloud/tasks

• 参数说明

  参数	是否必选	类型	说明
  project_id	是	String	服务所在区域对应的项目ID，获取方法请参见获取项目ID。

请求

• 请求样例（VIS输入+DIS输出）

  POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-safetysuitedetection-cloud/tasks
  {
      "name": "safetysuitedetection-cloud-task",
      "input": {
          "type": "vis",
          "data": [
              {
                  "stream_name": "vis-campusgo",
                  "index": 0
              }
          ]
      },
      "output": {
          "dis": {
              "stream_name": "dis-campusgo"
          }
      },
      "service_version": "3.0",
      "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
      "service_config": {
          "common": {
                "hat_detection_sw": 0,
                "cloth_detection_sw": 1,
                "render_result_sw": 1,
                "render_roi_sw": 1,
                "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}",
                "image_compression_ratio":90
          }
     }
  }

• 参数说明

  参数	是否必选	类型	说明
  name	是	String	作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。
  description	否	String	作业描述信息，最大长度为500字符长度。
  input	是	Object	视频数据输入列表，目前云上工服工帽检测支持以下输入类型： vis：从视频接入服务中读取视频数据。 详细参数定义参见task.input（任务输入参数）。
  service_version	是	String	功能版本号，版本号为3.0。
  resource_order_id	是	String	购买的算法能力包ID，在服务界面购买算法能力包获取。
  output	是	Object	结果数据的输出列表，目前支持将结果输出到您指定的通道中，输出类型为“dis”。 详细参数定义参见task.output（任务输出参数）。
  service_config	否	Object	服务的算法配置，配置参数见ServiceConfig参数说明。

• service_config中common的参数说明

  字段	是否必选	类型	说明
  hat_detection_sw	否	Int	对应控制台的界面参数“工帽检测开关”。 检测工帽开关： 0：表示不检测。 1：表示检测。 默认值为1。
  cloth_detection_sw	否	Int	对应控制台的界面参数“工服检测开关”。 检测工服开关： 0：表示不检测。 1：表示检测。 默认值为1。
  render_result_sw	否	Int	对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制； "1"：表示用红色绘制告警目标边框。 默认值为0。
  render_roi_sw	否	Int	对应控制台的界面参数“检测区域渲染开关”。 输出图像是否绘制检测区域，取值范围: "0"：表示不绘制； "1"：表示用黄色绘制用户设定区域。 默认值为0。
  target_roi	否	String	对应控制台的界面参数“检测区域设置”。 表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。 例如： {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]} 参数没有携带时，默认区域为整个视频帧。
  image_compression_ratio	否	Int	对应控制台的界面参数“图片压缩比”。 图片压缩百分比，取值范围为[20，100]。 默认值：90，表示图片压缩比为90%。

响应

• 响应样例

  [
    { 
      "id": "3d7c81cf35784d88a4e26066bcc5debd"
    }
  ]

• 返回作业ID列表

  参数	类型	说明
  id	String	作业ID。

检测结果

• 输出JSON数据流到DIS指定的通道，包括告警结构化数据和图片数据。
• JSON结果示例：

  {
       "stream_id": "vis-campusgo",
       "event_type":589824,
       "task_id":"3d7c81cf35784d88a4e26066bcc5debd",
       "timestamp": 1527603463,
       "message_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
       "data":{
           "event_set":[
               {
                    "bounding_box":{
                         "x":100,
                         "y":200,
                         "w":80,
                         "h":150
                     }
                    "type_cloth":0,
                    "type_hat":0
                 },
                {
                     "bounding_box":{
                          "x":200,
                          "y":300,
                          "w":70,
                          "h":150
                     }
                    "type_cloth":0,
                    "type_hat":1
                 }
             ]   
        },
       "image_base64": "/3j24AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..."
  }

返回值

• 正常

  201

• 异常

  返回值	说明
  400 Bad Request	请求错误，具体返回错误码请参考错误码。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误
  503 Service Unavailable	服务不可用。