本文为您介绍IPC视频目标检测DetectVideoIPCObject的语法及示例。

功能描述

IPC视频目标检测能力可以检测到输入视频中的目标物体,例如人、车辆、宠物等。

应用场景

  • 智能看家:家中有人或宠物移动时可生成高精度视频,实现检测提醒功能。且可以关注宠物在家中的活动状况。
  • 智能看店:可对门店起到安防作用,尤其是在夜间,可及时知道有人进店。
  • 智能看厂:安全是厂区非常重要的事情,对于人员在岗以及人员入侵可以起到良好的监管作用。

特色优势

  • 适用场景多:适应多种广泛的日常场景的目标检测,室内、室外、家居、店铺、商场、白天、夜间等。
  • 检测范围广:可检测的目标大小范围广,适用于大目标检测,也适用于较远摄像头下的小目标检测。
  • 检测效率高:高并发处理,处理时间短。

前提条件

请确保您已开通目标检测服务,若未开通服务请立即开通

输入限制

  • 视频格式:H264、H265。
  • 视频分辨率:大于20×20像素,小于4096×4096像素。
  • 视频大小:不超过10 MB。
  • 视频时长:不超过10秒。
  • URL地址中不能包含中文字符。

计费说明

关于IPC视频目标检测的计费方式及报价,请参见计费介绍

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

调试

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

请求参数

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

系统规定参数。取值:DetectVideoIPCObject

VideoURL String http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/guotian.xgt/test_images/test_video

视频文件URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

StartTimestamp Long 1629086400

视频实际开始时间的时间戳。例如视频开始时间是2021年8月16日12:00,对应时间戳为1629086400。

CallbackOnlyHasObject Boolean true

是否回调消息过滤。

  • true:如果输入的视频中检测到有目标,才会执行回调,否则不执行。
  • false: 无论是否检测到有目标,都执行回调。

返回数据

名称 类型 示例值 描述
RequestId String 35B11E1B-800C-4598-B5AA-577E3BDBD917

请求ID。

Data Object

返回的结果数据内容。

Width Long 1280

视频宽度分辨率,单位像素。

Height Long 720

视频高度分辨率,单位像素。

Frames Array of Frame

视频帧的集合,未检测到目标的帧不列出。

Time Long 6124533574

时间戳,单位秒。

Elements Array of elements

检测到的目标集合,如果没有目标则为空。

Type String PERSON

检测框对应的物体名称。取值如下:

  • PERSON:人
  • VEHICLE:车辆
  • PET:宠物
X Long 289

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

Y Long 271

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

Width Long 100

检测框宽度,单位像素。

Height Long 156

检测框高度,单位像素。

Score Float 0.7812

检测框的置信度,取值范围为[0.0,1.0]。

InputFile String oss://public-vigen-video/guotian.xgt/test_images/test_video

输入文件信息。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectVideoIPCObject
&VideoURL=http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/guotian.xgt/test_images/test_video
&StartTimestamp=1629086400
&CallbackOnlyHasObject=true
&公共请求参数

正常返回示例

XML格式

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

<RequestId>35B11E1B-800C-4598-B5AA-577E3BDBD917</RequestId>
<Data>
    <Width>1280</Width>
    <Height>720</Height>
    <Frames>
        <Time>6124533574</Time>
        <Elements>
            <Type>PERSON</Type>
            <X>289</X>
            <Y>271</Y>
            <Width>100</Width>
            <Height>156</Height>
            <Score>0.7812</Score>
        </Elements>
    </Frames>
    <InputFile>oss://public-vigen-video/guotian.xgt/test_images/test_video</InputFile>
</Data>

JSON格式

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

{
  "RequestId" : "35B11E1B-800C-4598-B5AA-577E3BDBD917",
  "Data" : {
    "Width" : 1280,
    "Height" : 720,
    "Frames" : [ {
      "Time" : 6124533574,
      "Elements" : [ {
        "Type" : "PERSON",
        "X" : 289,
        "Y" : 271,
        "Width" : 100,
        "Height" : 156,
        "Score" : 0.7812
      } ]
    } ],
    "InputFile" : "oss://public-vigen-video/guotian.xgt/test_images/test_video"
  }
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果

错误码

关于IPC视频目标检测的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

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