华为云用户手册

响应 响应样例 { "id":"ee7d7f5c7ba24839b6abaf5b81607496", "name":"flowcount-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"flowcount task test", "service_version":"3.0", "edge_pool_id":"9358ac0425b24a07b3258cffa2f0f0d6", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-23T06:19:44Z", "updated_at":"2020-09-23T06:19:44Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "line_count_interval":2, "region_count_interval":2, "line_detection_sw":1, "region_detection_sw":1, "heatmap_detection_sw":0, "heatmap_detection_interval":60, "heatmap_point_interval":4 } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（摄像头输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks { "name": "c-urban-trash-detect-edge-task", "description": "c-urban-trash-detect-edge test", "input": { "type": "edgecamera", "data": [ { "id": "25292206-995f-4c31-bfd5-b0dd7bc389e7", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "image_compression_ratio": 90, "trash_detect_sw": 1, "person_constraint_sw": 0, "min_trash_size": 1, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks { "name": "c-urban-trash-detect-edge-task", "description": "c-urban-trash-detect-edge test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "image_compression_ratio": 90, "trash_detect_sw": 1, "person_constraint_sw": 0, "min_trash_size": 1, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks { "name": "c-urban-trash-detect-edge-task", "description": "c-urban-trash-detect-edge test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "image_compression_ratio": 90, "trash_detect_sw": 1, "person_constraint_sw": 0, "min_trash_size": 1, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道 。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见ServiceConfig参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 image_compression_ratio 否 Int 对应控制台的界面参数“图片压缩比”。 图片压缩百分比，取值范围为[20，100]。 默认值：90，表示图片压缩比为90%。 trash_detect_sw 否 Int 对应控制台的界面参数“垃圾检测开关”。 "1"：表示检测垃圾； "2"：表示检测垃圾并检测疑似丢垃圾的人。 默认值为1。 person_constraint_sw 否 Int 对应控制台的界面参数“邻近行人约束开关”。当开关打开时，垃圾附近有行人逗留的告警将被过滤。 "0"：表示不开启开关； "1"：表示开启开关； 默认值为0。 min_trash_size 否 Int 对应控制台的界面参数“垃圾最小尺寸”。由于不同应用场景对垃圾的定义不同，用户可自定义配置垃圾最小尺寸，小于该尺寸的垃圾目标将不被告警。取值范围[1, 500]。单位为像素。 默认值为1。 render_result_sw 否 Int 对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制； "1"：表示用红色绘制告警目标边框。 默认值为0。 render_roi_sw 否 Int 对应控制台的界面参数“检测区域渲染开关”。 输出图像是否绘制检测区域，取值范围: "0"：表示不绘制； "1"：表示用黄色绘制用户设定区域。 默认值为0。 target_roi 否 String 对应控制台的界面参数“检测区域设置”。 表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。格式参见设置taeget_roi。例如： {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]],"name":"polygon"}]} 可为每个区域设置名称，后续输出结果时会连带输出区 域名 称。 参数没有携带时，默认区域为整个视频帧，默认区域名称为空字符串。

响应 响应样例 { "id": "8656efdafebf440bb7008f174db6c567", "name": "queue-status-analysis-edge", "creator": "user_test", "project_id": "1f793beac00d4801874db741cbfe10fa", "description": null, "service_version": "3.0", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at": "2020-09-18T03:35:03Z", "updated_at": "2020-09-18T03:35:51Z", "state": "RUNNING", "input": { "type": "edgecamera", "data": [{ "id": "aec5857c-222f-4aa9-be39-23654e118886", "index": 0 }] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config": { "common": { "image_compression_ratio": 90, "render_result_sw": 1, "render_roi_sw": 1, "queue_length_count_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[0, 0], [0, 1000], [1920, 1000], [1920, 0]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"5c127c7844674d2382b7daae07794152", "name":"c-urban-trash-detect-cloud-test", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"c-urban-trash-detect-cloud task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"vis-input", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-output" } }, "service_config":{ "common":{ "image_compression_ratio": 90, "trash_detect_sw": 1, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"cf9631594c9e48d7b04660da94a2bb94", "name":"face_cloud_0", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"face detection task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T02:54:53Z", "updated_at":"2020-09-22T02:54:53Z", "state":"RUNNING", "input":{ "type":"vis", "data":[ { "stream_name":"face", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-face", "data_category":[ "FaceImage", "OriginImage" ] } }, "service_config":{ "common":{ "detection_max_size":800, "detection_min_size":120, "origin_image_send_sw":0, "image_compression_ratio":90, "frame_skip_number":0, "face_first_send_threshold":0.5, "face_must_send_sw":0, "face_repeat_send_sw":0, "face_repeat_send_mode":"QUALITY_STEP", "face_repeat_send_step":1.2, "face_repeat_send_interval":1, "target_roi": "{\"polygos\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（摄像头输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-living-detect-edge/tasks { "name": "living-detect-edge-task", "description": "living detecttask test", "input": { "type": "edgecamera", "data": [ { "id": "9f8933c9-448c-48e5-8bc0-631ea83b92eb", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-living-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "detection_max_size": 50, "detection_min_size": 5, "image_compression_ratio": 90, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-living-detect-edge/tasks { "name": "living-detect-edge-task", "description": "living detecttask test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-living-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "detection_max_size": 50, "detection_min_size": 5, "image_compression_ratio": 90, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-living-detect-edge/tasks { "name": "living-detect-edge-task", "description": "living detect task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "dis": { "stream_name": "dis-living-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "detection_max_size": 50, "detection_min_size": 5, "image_compression_ratio": 90, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道 。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见ServiceConfig参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 detection_max_size 否 Int 对应控制台的界面参数“检测目标最大像素值”。 表示发送活物图片长宽的最大像素，取值范围[30,1000]，默认值：50。 detection_min_size 否 Int 对应控制台的界面参数“检测目标最小像素值”。 表示发送活物图片长宽的最小像素，取值范围[5,300]，默认值：5。 target_roi 否 String 对应控制台的界面参数“区域设置”。 疑似活物的检测区域，当在该区域内的疑似活物被检测到时，触发告警。 该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。 例如： {"polygons":[{"data":[[43,266],[42,645],[472,644],[416,212]]},{"data":[[311,182],[282,670],[941,661],[835,170]]}]} 参数没有携带时，默认全屏都是检测区域。 render_result_sw 否 Int 对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制。 "1"：表示用红色绘制告警目标边框。 默认值为0。 render_roi_sw 否 Int 对应控制台的界面参数“检测区域渲染开关”。 输出图像是否绘制检测区域，取值范围: "0"：表示不绘制。 "1"：表示用黄色绘制用户设定区域。 默认值为0。 image_compression_ratio 否 Int 对应控制台的界面参数“图片压缩比”。 输出图片压缩百分比，取值范围为[20，100]。 默认值：90，表示图片压缩比为90%。

响应 响应样例 { "id":"61761681a6014e7c9024d642a0d4d412", "name":"wear-mask-recog-edge-test", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"wear-mask-recog-edge test", "service_version":"3.0", "edge_pool_id":"793f2ae4032b44929cfec2dbcca7c415", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-18T03:35:03Z", "updated_at":"2020-09-18T03:35:51Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "image_compression_ratio":90 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id": "8656efdafebf440bb7008f174db6c567", "name": "living-detect-edge", "creator": "user_test", "project_id": "1f793beac00d4801874db741cbfe10fa", "description": null, "service_version": "3.0", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at": "2020-09-18T03:35:03Z", "updated_at": "2020-09-18T03:35:51Z", "state": "RUNNING", "input": { "type": "edgecamera", "data": [{ "id": "aec5857c-222f-4aa9-be39-23654e118886", "index": 0 }] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config": { "common": { "detection_max_size": 50, "detection_min_size": 5, "image_compression_ratio": 90, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"5c127c7844674d2382b7daae07794152", "name":"event-action-recog-cloud-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"event-action-recog task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"pose-action-recog-cloud-video", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-pose-action-recog-cloud" } }, "service_config":{ "common":{ "climb_detection_sw":1, "fall_detection_sw":0, "wave_detection_sw":0, "bend_detection_sw":0, "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[0,0],[0,1080],[1920,1080],[1920,0]]}]}", "image_compression_ratio":90 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id":"a29dfa1bfcdd4a62b3f6048fe6965e8b", "name":"fightingdetection_edge_task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"fighting detection task test", "service_version":"3.0", "edge_pool_id":"8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-21T12:57:12Z", "updated_at":"2020-09-21T12:57:12Z", "state":"PENDING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "render_result_sw":1, "image_compression_ratio":90, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"2f268b9472a544e991eae3c5c3534f5b", "name":"queue-status-analysis-cloud-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"qqueue-status-analysis-cloud task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-21T12:57:12Z", "updated_at":"2020-09-21T12:57:12Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"queue-status-analysis-stream", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-queue-status-analysis" } }, "service_config":{ "common":{ "image_compression_ratio":90, "render_result_sw":1, "render_roi_sw":1, "queue_length_count_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[0, 0], [0, 1000], [1920, 1000], [1920, 0]]}]}" } } } 响应参数说明 请参考作业详情参数。

提取结果 输出的JSON字符串主要包含两类信息：人脸图和原始图。 输出类型支持配置data_category参数，取值范围为[FaceImage,OriginImage]，分别表示是否发送人脸图和原始图（发送原始图片前，需要将origin_image_send_sw参数设置为1）。 支持输出JSON字符串到指定的DIS。 支持输出JSON字符串和图片到localpath（边缘节点本地路径），具体请参见存储路径的创建规则。 支持输出JSON字符串到用户填写的webhook请求头指定的URL。 输出结果示例： 人脸图的JSON示例 输出人脸图的JSON字符串到DIS： { "event_type": 65536, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217", "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "origin_image_path":"001/originimage/20181121/pic/2.jpg", "origin_json_path":"001/originimage/20181121/json/2.txt", "bounding_box": { "x": 32, "y": 379, "w": 49, "h": 65 } }, "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..." } 输出人脸图的JSON字符串到localpath: { "event_type": 65536, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217", "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218", "image_path": "001/faceimage/20181121/pic/1.jpg", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "origin_image_path":"001/originimage/20181121/pic/2.jpg", "origin_json_path":"001/originimage/20181121/json/2.txt", "bounding_box": { "x": 32, "y": 379, "w": 49, "h": 65 } } } 输出人脸图的JSON字符串到webhook指定的URL： { "event_type": 65536, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217", "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "origin_image_path":"001/originimage/20181121/pic/2.jpg", "origin_json_path":"001/originimage/20181121/json/2.txt", "bounding_box": { "x": 32, "y": 379, "w": 49, "h": 65 } }, "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..." } 原始图的JSON示例 输出原始图的JSON到DIS： { "event_type": 65537, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", }, "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..." } 输出原始图的JSON到localpath： { "event_type": 65537, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "image_path": "001/originimage/20181121/pic/1.jpg" } } 输出原始图的JSON到webhook指定的URL： { "event_type": 65537, "task_id": "a066974ae7334649a37257242c5fa4c3", "stream_id": "001", "timestamp": 1527603463, "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688", "data": { "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97", "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", }, "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..." } 人脸图的JSON字段说明： JSON格式说明 字段 类型 说明 stream_id String 摄像头ID。 event_type Uint64 快速标识人脸提取算法的输出消息类型。人脸图json消息固定为65536，对应16进制为 0x 0000 0000 0001 0000。 task_id String 作业ID。 timestamp Uint64 图片解码时间的时间戳。 message_id String 本条数据的UUID。 image_base64 String 人脸图Base64编码结果，输出类型为DIS、webhook时携带此字段。 data Object 人脸图业务输入内容。 data参数格式说明 字段 类型 说明 node_id String 边缘节点编号。 face_id String 人脸图UUID。 detection_id String 人脸的检测ID，相同的detection_id表示同一个人脸。由于遮挡等原因，会存在人的跟踪路线丢失而ID发生变化的情况，所以该字段不建议作为检测自然人的唯一标识，仅作为辅助手段使用。 image_path String 人脸图本地存储路径，仅当输出类型为LOCALPATH时携带此字段。 该路径（image_path）生成规则为“{stream_id}/faceimage/{当前日期}/pic/*.jpg”，文件名从“1.jpg”开始依次编号。 人脸图片绝对路径={用户输入的挂载路径}+{image_path}。 origin_image_id String 人脸原始图UUID。如果“origin_image_send_sw”参数设为 0，即不输出原始图，则该字段为“00000000-0000-0000-0000-000000000000”。 origin_image_path String 原始图本地存储路径。当原始图输出类型为Localpath并开启“发送原图开关”时，该字段才有信息，否则，字段内容为空。 该路径（origin_image_path）生成规则为“{stream_id}/originimage/{当前日期}/pic/*.jpg”，文件名从“1.jpg”开始依次编号。 原始图绝对路径={用户输入挂载路径}+{origin_image_path}。 origin_json_path String 原始图JSON结构化信息本地存储路径。当原始图输出类型为Localpath并开启“发送原图开关”时，该字段才有信息，否则，字段内容为空。 该路径（origin_json_path）生成规则为“{stream_id}/originimage/{当前日期}/json/*.txt”，文件名从“1.txt”开始依次编号。 原始图JSON结构化信息绝对路径={用户输入挂载路径}+{origin_json_path}。 bounding_box Object 人脸图在原始图中的位置信息。 bounding_box参数格式说明 字段 类型 说明 x Int 矩形框左上角横坐标。 y Int 矩形框左上角纵坐标。 w Int 矩形框宽度。 h Int 矩形框高度。 原始图的JSON字段说明： JSON格式说明 字段 类型 说明 stream_id String 摄像头编号。 event_type Uint64 快速标识人脸提取算法的输出消息类型。原始图json消息固定为65537，对应16进制为 0x 0000 0000 0001 0001。 task_id String 作业ID。 timestamp Uint64 图片解码时间的时间戳。 message_id String 本条数据的UUID。 image_base64 String 原始图Base64编码结果，输出类型为DIS、webhook时携带此字段。 data Object 原始图业务输入内容。 data参数格式说明 字段 类型 说明 node_id String 边缘节点编号。 origin_image_id String 人脸原始图UUID。 image_path String 原始图信息本地存储路径，仅当输出类型为LOCALPATH时携带此字段。 该路径（image_path）生成规则为“{stream_id}/originimage/{当前日期}/pic/*.jpg”，文件名从“1.jpg”开始依次编号。 原始图绝对路径={用户输入挂载路径}+{image_path}。 输出类型为LOCALPATH时，会根据用户的选择，将人脸图或者原始图存储在边缘节点上，图片和JSON结构化信息分开存储。具体存储路径按照如下规则创建： 人脸图JSON结构数据 文件绝对路径={用户输入的挂载路径}/{stream_id}/faceimage/{当前日期}/json/*.txt 人脸图 文件绝对路径={用户输入的挂载路径}/{stream_id}/faceimage/{当前日期}/pic/*.jpg 原始图JSON结构数据 文件绝对路径={用户输入的挂载路径}/{stream_id}/originimage/{当前日期}/json/*.txt 原始图 文件绝对路径={用户输入的挂载路径}/{stream_id}/originimage/{当前日期}/pic/*.jpg 文件名从1.txt或者1.jpg开始依次编号，人脸图或者原始图的JSON结构数据，与图片文件名相互对应。文件按照天存储，可以通过输入参数local_file_save_time对保存的天数进行控制，超期的文件将被自动删除。 当使用同一个摄像头下发多个视觉作业的时候，需要确保每一个作业的挂载路径不一样，否则不同任务的数据会写到同一个文件夹下，造成数据冲突。 当选择Localpath作为输出类型时，并且设置了发送原始图，挂载点路径需要有足够多的硬盘空间来保存原始图，否则会把挂载点的磁盘空间耗尽。

请求 请求样例（摄像头输入+DIS/Localpath/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-face-edge/tasks { "name":"face_edge", "description":"face detection task test", "service_version":"3.0", "input":{ "type":"edgecamera", "data":[ { "index":0, "id":"6233039b-698f-4347-8ced-ef0d14605c0b" } ] }, "output":{ "dis":{ "stream_name":"dis-face", "data_category":[ "FaceImage", "OriginImage" ] }, "localpath":{ "mount_source_path":"/tmp/", "data_category":[ "FaceImage", "OriginImage" ] }, "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" }, "data_category":[ "FaceImage", "OriginImage" ] } }, "edge_pool_id":"e9bf9ebe497d4c9bb2e65d1f99fe1ff9", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "service_config":{ "common":{ "detection_max_size":800, "detection_min_size":120, "origin_image_send_sw":0, "face_first_send_threshold":0, "face_must_send_sw":0, "face_repeat_send_sw":1, "face_repeat_send_mode":"PERIOD", "face_repeat_send_step":1, "face_repeat_send_interval":1, "image_compression_ratio":90, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-face-edge/tasks { "name": "face_edge", "description": "face detection task test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "face-edge", "data_category":[ "FaceImage", "OriginImage" ] }, "webhook": { "url": "https://apigw.huawei.com/api/mqs/message/sit", "headers": { "content-type": "application/json" }, "data_category":[ "FaceImage", "OriginImage" ] } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "detection_max_size": 800, "detection_min_size": 120, "origin_image_send_sw": 0, "image_compression_ratio": 90, "frame_skip_number": 0, "local_file_save_time": 1, "face_first_send_threshold": 0.5, "face_must_send_sw": 0, "face_repeat_send_sw": 0, "face_repeat_send_mode": "QUALITY_STEP", "face_repeat_send_step": 1.2, "face_repeat_send_interval": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-face-edge/tasks { "name": "face_edge", "description": "face detection task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "stream_type": 1, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6" } ] }, "output": { "dis": { "stream_name": "face-edge", "data_category":[ "FaceImage", "OriginImage" ] }, "webhook": { "url": "https://apigw.huawei.com/api/mqs/message/sit", "headers": { "content-type": "application/json" }, "data_category":[ "FaceImage", "OriginImage" ] } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "detection_max_size": 800, "detection_min_size": 120, "origin_image_send_sw": 0, "image_compression_ratio": 90, "frame_skip_number": 0, "local_file_save_time": 1, "face_first_send_threshold": 0.5, "face_must_send_sw": 0, "face_repeat_send_sw": 0, "face_repeat_send_mode": "QUALITY_STEP", "face_repeat_send_step": 1.2, "face_repeat_send_interval": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）、中文组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道，输出JSON格式信息，包括提取的人脸图和原始图片的Base64编码。 Webhook：将结果输出到Webhook URL，输出JSON格式信息，包括提取的人脸图和原始图片。Webhook URL地址为用户指定的URL地址，例如用户指定URL地址为：“https://www.face.com”，则算法服务会把提取的人脸图和原始图以POST请求的方式发送到上述URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”，输出人脸图片和JSON结构化信息。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务算法配置，字段结构参见service_config参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 detection_max_size 否 Int 对应控制台的界面参数“检测目标最大像素值”。 表示发送人脸图片长宽的最大像素，取值范围[90, 1000]，默认值：800。 如果该参数设置得过小，人脸提取的准确率会受到影响。 detection_min_size 否 Int 对应控制台的界面参数“检测目标最小像素值”。 表示发送人脸图长宽的最小像素，取值范围[90, 1000]，默认值：120。 如果该参数设置得过大，人脸提取的准确率会受到影响； 如果该参数设置得过小，则可能提取到分辨率较低的人脸图。 origin_image_send_sw 否 Int 对应控制台的界面参数“发送原图开关”。 表示是否发送人脸原始图，取值范围： 0：表示不发送原图。 1：表示发送原图。 默认值：0。 image_compression_ratio 否 Int 对应控制台的界面参数“原图压缩比”。 表示原始图的图片压缩比（人脸图不受影响），取值范围为[20，100]。数值越低，原始图越模糊。 默认值：90，表示图片压缩比为90%。 注意：该参数不对人脸图生效。 frame_skip_number 否 Int 对应控制台的界面参数“跳帧数”。 表示每分析视频1帧画面后，所跳过的帧数。例如设置为2，表示每处理1帧跳过2帧。取值范围[0, 10]，默认值0。 该参数值越大，算法的性能消耗就越低，但会影响人脸提取的效果。 local_file_save_time 否 Int 对应控制台的界面参数“本地存储时间”。 表示本地文件保存时间，单位为天，超期会被自动删除。输出类型为Localpath（即将作业的运行结果保存在边缘节点本地）时生效，取值范围[1, 180]，默认值为1（天）。 face_first_send_threshold 否 Float 对应控制台的界面参数“人脸首次发送时间”。 表示从检测出人脸到发送人脸图之间的计时，单位为s，取值范围[0, 360]，默认值0。 从人脸被检测跟踪开始计时，至该参数所设置的时间结束，算法会选择期间满足发送条件且质量最好的人脸图进行发送。 如果到达所设置的时间，目标都没有出现满足发送条件的人脸图，则时间顺延，直到出现满足发送条件的人脸图，或者直到目标消失，才停止计时。 如果目标在计时过程中（含顺延时间）消失，则从期间满足发送条件的提取结果中，选择质量最好的一张人脸图进行发送； 但如果该目标的全部提取结果均不满足发送条件，则根据“face_must_send_sw”参数的取值，分两种情况： a. 如果“face_must_send_sw”设为 0，则不发送该目标的人脸图； b. 如果“face_must_send_sw”设为 1，尽管该目标没有符合满足发送条件的人脸图，但还是会从提取结果中选择一张质量“相对较好”的人脸图进行发送。 face_must_send_sw 否 Int 对应控制台的界面参数“人脸必须发送开关”。 表示检测出行人后是否必须发送一张人脸： 0：表示非必须发送。 1：表示必须发送。 默认值0。 当本参数设为1时，即使行人在跟踪范围内都没有满足发送条件的人脸，也会发送一张人脸。 face_repeat_send_sw 否 Int 对应控制台的界面参数“人脸重复发送开关”。 表示是否重复发送同一位行人的多张人脸图。 0：表示不重复发送。 1：表示重复发送。 默认值0。 本参数设为1后，需配合“face_repeat_ send_mode”参数及“face_repeat_send_step”/“face_repeat_send_interval”参数共同使用，从而选择以质量递增或者周期发送的模式，来发送同一个人的多张人脸图。 用户可通过输出结果中的“detection_id”来检测是否同一个人。 face_repeat_send_mode 否 String 对应控制台的界面参数“人脸重复发送模式”。 表示对同一位行人多张脸图的发送模式，取值范围： QUALITY_STEP：按质量递增的模式发送，需配合“face_repeat_send_step”参数使用。对同一位行人，当新检测到的脸图质量高于已发送脸图质量一定程度时，会再次发送。 PERIOD：按时间周期的模式发送，需配合“face_repeat_send_interval”参数使用。对同一位行人，选取每个时间周期内质量最优人脸进行发送。 默认值为QUALITY_STEP。 face_repeat_send_step 否 Float 对应控制台的界面参数“人脸重复发送质量倍数”。 表示人脸图重复发送的质量递增倍数。 对同一位行人，当新检测到的人脸图质量大于已发送人脸图一定程度时，触发再次发送一张人脸图，取值范围[1.0, 10.0]。 默认值为1.2，表示新人脸图的质量必须大于已发送人脸图质量的1.2倍时，才会再次发送。 face_repeat_send_interval 否 Int 对应控制台的界面参数“人脸重复发送周期”。 表示重复发送人脸图的周期时间。对同一位行人，在每个周期（该参数确定具体时间）结束时，选取该周期内质量最好的人脸图发送一次。单位为s，取值范围[0,360]，默认值为1。 target_roi 否 String 对应控制台的界面参数“检测区域设置”。 表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。 例如： {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]} 参数没有携带时，默认区域为整个视频帧。

功能介绍 该API用于分析检测视频流中的人脸并输出图片。 支持H264、H265编码格式的RTSP视频流。 视频中人脸大小不低于90*90像素。 通过DIS通道输出原图时，请使用DIS高级通道，以免因通道带宽过小而丢失原图数据。 作业运行中请勿改变视频分辨率；若确有需要，请重新下发作业。 如果输出方式选择Localpath，在创建边缘运行池时需填写主机挂载路径。该路径要求真实存在于边缘节点，路径需与算法作业Localpath输出方式的挂载源路径一致。

响应 响应样例（VIS输入+DIS输出） { "id":"5c127c7844674d2382b7daae07794152", "name":"c-living-detect-cloud-test", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"c-living-detect task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"c-living-detect-cloud-video", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-living-detect-cloud" } }, "service_config":{ "common":{ "detection_max_size":50, "detection_min_size":5, "image_compression_ratio":90, "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"3d7c81cf35784d88a4e26066bcc5debd", "name":"staffonduty_cloud_0", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"staffonduty task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T07:55:13Z", "updated_at":"2020-09-22T07:55:13Z", "state":"RUNNING", "input":{ "type":"vis", "data":[ { "stream_name":"staffonduty", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-staffonduty" } }, "service_config":{ "common":{ "target_roi":"{\"polygons\":[{\"data\":[[484,465],[1850,450],[1905,1013],[515,1050]]},{\"data\":[[484,125],[1800,125],[1800,677],[495,677]]}]}", "image_compression_ratio":90, "key_region_detection_sw":1, "key_region_detect_interval":2, "key_region_detect_threshold":2, "key_region_person_count":50 } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（摄像头输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-wear-mask-recog-edge/tasks { "name": "wear-mask-recog-edge-task", "description": "wear-mask-recog-edge test", "input": { "type": "edgecamera", "data": [ { "id": "aec5857c-222f-4aa9-be39-23654e118886", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-vias" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe6x4e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "image_compression_ratio":90 } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-wear-mask-recog-edge/tasks { "name": "wear-mask-recog-edge-task", "description": "wear-mask-recog-edge task test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-vias" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "image_compression_ratio":90 } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-wear-mask-recog-edge/tasks { "name": "wear-mask-recog-edge-task", "description": "wear-mask-recog-edge task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type": 1 } ] }, "output": { "dis": { "stream_name": "dis-vias" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type": "application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "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 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道 。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见ServiceConfig参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 render_result_sw 否 Int 对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制。 "1"：表示用红色绘制告警目标边框。 默认值为1。 render_roi_sw 否 Int 对应控制台的界面参数“检测区域渲染开关”。 输出图像是否绘制检测区域，取值范围: "0"：表示不绘制。 "1"：表示用黄色绘制用户设定区域。 默认值为1。 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%。

响应 响应样例（VIS输入+DIS输出） { "id":"5d127c7844674d2382b7daae07794152", "name":"sharedbicycledetection-cloud-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"Sharedbicycledetection task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"sharedbicycledetection-cloud-video", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-sharedbicycledetection-cloud" } }, "service_config":{ "common":{ "alert_mode":"single", "alert_detection_interval":60, "illegal_park_alert_threshold":30, "render_result_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "image_compression_ratio":90 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"5c127c7844674d2382b7daae07794152", "name":"wear-mask-recog-cloud-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"wear-mask-recog task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"wear-mask-recog-cloud-video", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-wear-mask-recog-cloud" } }, "service_config":{ "common":{ "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[0,0],[0,1080],[1920,1080],[1920,0]]}]}", "image_compression_ratio":90 } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（VCN输入+WEBHOOK输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-fightdetect-edge/tasks { "name": "fightingdetection_edge_task", "description": "fighting detection task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "image_compression_ratio": 90, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例2（摄像头输入+DIS输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-fightdetect-edge/tasks { "name": "fightingdetection_edge_task", "description": "fighting detection task test", "input": { "type": "edgecamera", "data": [ { "id": "aec5857c-222f-4aa9-be39-23654e118886", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-fightdetect-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "image_compression_ratio": 90, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例3（edgerestful输入+DIS输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-fightdetect-edge/tasks { "name": "fightingdetection_edge_task", "description": "fighting detection task test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-fightdetect-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "image_compression_ratio": 90, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 请求样例4（VCN输入+DIS输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-fightdetect-edge/tasks { "name": "fightingdetection_edge_task", "description": "fighting detection task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "dis": { "stream_name": "dis-fightdetect-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "render_result_sw": 1, "image_compression_ratio": 90, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[100,100],[1800,100],[1800,1000],[100,1000]]}]}" } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道 。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见service_config参数说明。 service_config参数说明 参数 是否必选 类型 说明 common 否 Object 作业参数配置，配置参数见common参数说明。 common参数说明 参数 是否必选 类型 说明 render_result_sw 否 Int 对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制。 "1"：表示用红色绘制告警目标边框。 默认值为0。 image_compression_ratio 否 Int 对应控制台的界面参数“图片压缩比”。 取值范围[20，100]，默认值：90，表示图片压缩比90%。 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]]}]} 参数没有携带时，默认区域为整个视频帧。

响应 响应样例 { "id":"01d0d8c40f24441c897db868e17a65db", "name":"staffonduty-T4M-edge_0", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"staffonduty task test", "service_version":"3.0", "edge_pool_id":"c22f30f7ee0643978e5b46e062bbc5d8", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-18T13:13:22Z", "updated_at":"2020-09-18T13:13:22Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"6233039b-698f-4347-8ced-ef0d14605c0b", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "target_roi": "{\"polygons\":[{\"data\":[[484,465],[1850,450],[1905,1013],[515,1050]]},{\"data\":[[484,125],[1800,125],[1800,677],[495,677]]}]}", "image_compression_ratio":90, "key_region_detection_sw":1, "key_region_detect_interval":2, "key_region_detect_threshold":2, "key_region_person_count":50 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id":"6c4f45a2bf404c65961c8bbf63ff5bf3", "name":"pose-action-recog-edge-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"pose-action-recog-edge task test", "service_version":"3.0", "edge_pool_id":"8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T04:35:27Z", "updated_at":"2020-09-22T04:35:27Z", "state":"PENDING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "climb_detection_sw":1, "fall_detection_sw":0, "wave_detection_sw":0, "bend_detection_sw":0, "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[0,0],[0,1080],[1920,1080],[1920,0]]}]}", "image_compression_ratio":90 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id":"8656efdafebf440bb7008f174db6c567", "name":"trash-abnormal-detect-edge", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":null, "service_version":"3.0", "edge_pool_id":"8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-18T03:35:03Z", "updated_at":"2020-09-18T03:35:51Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "alert_time_threshold":30, "render_result_sw":1, "render_roi_sw":1, "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]]},{\"data\":[[311,182],[282,670],[941,661],[835,170]]}]}", "image_compression_ratio":80 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id":"d92a3de2be594710a981dc673bf5a570", "name":"工服工帽-T4N-edge_0", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"safetysuitedetection-edge task test", "service_version":"3.0", "edge_pool_id":"ffa02c65f31446fda596744f93aba151", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-19T03:58:15Z", "updated_at":"2020-09-19T03:58:15Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"6233039b-698f-4347-8ced-ef0d14605c0b", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "hat_detection_sw":1, "cloth_detection_sw":1, "image_compression_ratio":90, "render_result_sw":1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "render_roi_sw":1 } } } 响应参数说明 请参考作业详情参数。

响应 响应样例 { "id":"61761681a6014e7c9024d642a0d4d412", "name":"abnormalpark-edge-task", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"Abnormalpark task test", "service_version":"3.0", "edge_pool_id":"793f2ae4032b44929cfec2dbcca7c415", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-18T03:35:03Z", "updated_at":"2020-09-18T03:35:51Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_config":{ "common":{ "target_roi":"{\"polygons\":[{\"data\":[[50,756],[50,756],[50,756],[100,616]],\"name\":\"a\"},{\"data\":[[50,256],[50,756],[50,756],[100,116]],\"name\":\"b\"}]}", "license_plate":{ "local_city":"B", "local_province":"津" }, "abnormal_park_threshold":180, "abnormal_park_output_interval":180, "output_image_sw":1 } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（摄像头输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-roadside-stall-edge/tasks { "name": "c-urban-roadside-stall-edge-task", "description": "c-urban-roadside-stall-edge test", "input": { "type": "edgecamera", "data": [ { "id": "25292206-995f-4c31-bfd5-b0dd7bc389e7", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "event_disappear_alert_sw": 0, "image_compression_ratio": 90, "roadside_stall_detect_sw": 1, "outstore_stall_detect_sw": 0, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-roadside-stall-edge/tasks { "name": "c-urban-roadside-stall-edge-task", "description": "c-urban-roadside-stall-edge test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "event_disappear_alert_sw": 0, "image_compression_ratio": 90, "roadside_stall_detect_sw": 1, "outstore_stall_detect_sw": 0, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-roadside-stall-edge/tasks { "name": "c-urban-roadside-stall-edge-task", "description": "c-urban-roadside-stall-edge test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "dis": { "stream_name": "dis-suxinxing" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "event_disappear_alert_sw": 0, "image_compression_ratio": 90, "roadside_stall_detect_sw": 1, "outstore_stall_detect_sw": 0, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道。 Webhook：将结果输出到Webhook URL。 详细参数定义参见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见ServiceConfig参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 image_compression_ratio 否 Int 对应控制台的界面参数“图片压缩比”。 图片压缩百分比，取值范围为[20，100]。 默认值：90，表示图片压缩比为90%。 event_disappear_alert_sw 否 Int 对应控制台的界面参数“事件消失告警开关”。 取值范围: "0"：表示不开启。 "1"：表示开启。 默认值为0。 roadside_stall_detect_sw 否 Int 对应控制台的界面参数“占道经营开关”。 "0"：表示不检测占道经营； "1"：表示检测占道经营。 默认值为1。 outstore_stall_detect_sw 否 Int 对应控制台的界面参数“出店经营开关”。 "0"：表示不检测出店经营； "1"：表示检测出店经营。 默认值为0。 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]],"name":"polygon"}]} 可为每个区域设置名称，后续输出结果时会连带输出区域名称。 参数没有携带时，默认区域为整个视频帧，默认区域名称为空字符串。 repeat_alert_sw 否 Int 对应控制台的界面参数“重复告警开关”。 是否对同一目标进行重复告警，取值范围： "0"：表示关闭，不重复告警； "1"：表示开启，重复告警。 默认值为0。 重复告警开关开启后，周期性的告警所有目标，同一目标每次告警的detection_id相同，参数repeat_alert_interval才会生效。 repeat_alert_interval 否 Int 对应控制台的界面参数“重复告警间隔”。 在参数repeat_alert_sw为1时才会生效。 控制重复告警的时间间隔，单位为秒。取值范围：[30, 86400]，最长时间间隔为24小时。 默认值为30。每30秒告警一次，同一个告警目标detection_id相同。

响应 响应样例 { "id":"8656efdafebf440bb7008f174db6c567", "name":"c-highpoint-crowdcount-edge-edge", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":null, "service_version":"3.0", "edge_pool_id":"8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2021-01-26T03:35:03Z", "updated_at":"2021-01-26T03:35:51Z", "state":"RUNNING", "input":{ "type":"edgecamera", "data":[ { "id":"aec5857c-222f-4aa9-be39-23654e118886", "index":0 } ] }, "output":{ "webhook": { "url": "https://apigw.huawei.com/api/mqs/message/sit", "headers": { "content-type": "application/json" } } }, "service_config":{ "common":{ "image_compression_ratio": 90, "trash_detect_sw": 1, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}" } } } 响应参数说明 请参考作业详情参数。

响应 响应样例（VIS输入+DIS输出） { "id":"5c127c7844674d2382b7daae07794152", "name":"c-highpoint-crowdcount-cloud-test", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"c-highpoint-crowdcount-cloud task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T08:08:39Z", "updated_at":"2020-09-22T08:08:39Z", "state":"PENDING", "input":{ "type":"vis", "data":[ { "stream_name":"intrusiondetectio", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-intrusion" } }, "service_config":{ "common":{ "image_compression_ratio": 90, "roadside_stall_detect_sw": 1, "outstore_stall _detect_sw": 0, "render_roi_sw": 1, "render_result_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}" } } } 响应参数说明 请参考作业详情参数。

请求 请求样例1（摄像头输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-trash-abnormal-detect-edge/tasks { "name": "trashabnormaldetect-edge-task", "description": "trashabnormaldetect task test", "input": { "type": "edgecamera", "data": [ { "id": "9f8933c9-448c-48e5-8bc0-631ea83b92eb", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-trashabnormaldetect-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "alert_time_threshold": 30, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]]},{\"data\":[[311,182],[282,670],[941,661],[835,170]]}]}", "image_compression_ratio": 80 } } } 请求样例2（edgerestful输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-trash-abnormal-detect-edge/tasks { "name": "trashabnormaldetect-edge-task", "description": "trashabnormaldetect task test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-trashabnormaldetect-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "alert_time_threshold": 30, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]]},{\"data\":[[311,182],[282,670],[941,661],[835,170]]}]}", "image_compression_ratio": 80 } } } 请求样例3（VCN输入+DIS/Webhook输出） POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-trash-abnormal-detect-edge/tasks { "name": "trashabnormaldetect-edge-task", "description": "trashabnormaldetect task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6", "stream_type":1 } ] }, "output": { "dis": { "stream_name": "dis-trashabnormaldetect-edge" }, "webhook": { "url": "https://apigw.huawei.com/api/event/callback", "headers": { "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "service_config": { "common": { "alert_time_threshold": 30, "render_result_sw": 1, "render_roi_sw": 1, "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]]},{\"data\":[[311,182],[282,670],[941,661],[835,170]]}]}", "image_compression_ratio": 80 } } } 参数说明 参数 是否必选 类型 说明 name 是 String 作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。 description 否 String 作业描述信息，最大长度为500字符长度。 input 是 Object 视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。 详细参数定义参见task.input（任务输入参数）。 service_version 是 String 功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。 resource_order_id 是 String 购买的算法能力包ID，在服务界面购买算法能力包获取。 edge_pool_id 是 String 边缘运行池ID，获取方法参见创建边缘运行池。 output 是 Object 结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道 。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。 详细参数定义见task.output（任务输出参数）。 service_config 否 Object 服务的算法配置，配置参数见ServiceConfig参数说明。 service_config中common参数说明 字段 是否必选 类型 说明 alert_time_threshold 否 Int 对应控制台的界面参数“告警触发时间”。当检测到垃圾桶状态异常达到该时长是触发告警。取值范围[30, 3600], 单位秒。 默认值：30。 target_roi 否 String 对应控制台的界面参数“区域设置”。 垃圾桶检测区域，当在该区域内的垃圾桶被检测到异常状态时，触发告警。 该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。 例如： {"polygons":[{"data":[[43,266],[42,645],[472,644],[416,212]]},{"data":[[311,182],[282,670],[941,661],[835,170]]}]} 参数没有携带时，默认全屏都是检测区域。 render_result_sw 否 Int 对应控制台的界面参数“目标框渲染开关”。 输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制。 "1"：表示用红色绘制告警目标边框。 默认值为0。 render_roi_sw 否 Int 对应控制台的界面参数“检测区域渲染开关”。 输出图像是否绘制检测区域，取值范围: "0"：表示不绘制。 "1"：表示用黄色绘制用户设定区域。 默认值为0。 image_compression_ratio 否 Int 对应控制台的界面参数“图片压缩比”。 输出图片压缩百分比，取值范围为[20，100]。 默认值：90，表示图片压缩比为90%。

响应 响应样例（VIS输入+DIS输出） { "id":"63eac48bf3704e8bb30af7f244fdcf3d", "name":"intrusiondetectio_cloud_0", "creator":"user_test", "project_id":"1f793beac00d4801874db741cbfe10fa", "description":"intrusiondetectio task test", "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "created_at":"2020-09-22T07:23:46Z", "updated_at":"2020-09-22T07:23:46Z", "state":"RUNNING", "input":{ "type":"vis", "data":[ { "stream_name":"intrusiondetectio", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-intrusion" } }, "service_config":{ "common":{ "car_detection_sw":0, "person_detection_sw":1, "detection_min_size":60, "detection_max_size":1080, "line_detection_sw":1, "region_detection_sw":1, "loitering_detection_sw":0, "image_compression_ratio":90, "render_result_sw":1, "target_roi": "{\"lines\":[{\"data\":[[560,680],[1185,506]],\"properties\":{\"side1_name\":\"Side1\",\"side2_name\":\"Side2\"}}],\"polygons\":[{\"data\":[[0,0],[0,1080],[1920,1080],[1920,0]]}]}", "render_roi_sw":1 } } } 响应参数说明 请参考作业详情参数。