接口说明
功能描述
IPC 视频目标检测能力可以检测到输入视频中的目标物体，例如人、车辆、宠物等。
- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
- 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
应用场景
- 智能看家：家中有人或宠物移动时可生成高精度视频，实现检测提醒功能。且可以关注宠物在家中的活动状况。
- 智能看店：可对门店起到安防作用，尤其是在夜间，可及时知道有人进店。
- 智能看厂：安全是厂区非常重要的事情，对于人员在岗以及人员入侵可以起到良好的监管作用。
特色优势
- 适用场景多：适应多种广泛的日常场景的目标检测，室内、室外、家居、店铺、商场、白天、夜间等。
- 检测范围广：可检测的目标大小范围广，适用于大目标检测，也适用于较远摄像头下的小目标检测。
- 检测效率高：高并发处理，处理时间短。
接入指引
-
注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
-
创建 AccessKey：请确保您已创建 AccessKey，如果您使用的是子账号 AccessKey，您需要给子账号赋予 AliyunVIAPIFullAccess 权限，具体操作，请参见 RAM 授权。
-
在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及 SDK 依赖信息，也可以下载完整的工程。
-
开发接入步骤：
- 在 SDK 总览中选择您要接入使用的 SDK 语言。
- 在对应语言的 SDK 文档中找到 AI 类目为目标检测（objectdet）类目的 SDK 包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
-
示例代码：该能力常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。
-
客户端直接调用：该能力常用的客户端调用方式包括以下几种。
输入限制
- 视频格式：H264、H265。
- 视频分辨率：大于 20×20 像素，小于 4096×4096 像素。
- 视频帧率：要求在 35 帧以内。
- 视频大小：不超过 10 MB。
- 视频时长：不超过 10 秒。
- URL 地址中不能包含中文字符。
计费说明
关于 IPC 视频目标检测的计费方式及报价，请参见计费介绍。
调用步骤
该能力为异步能力，需分两步进行调用。 第一步调用 DetectVideoIPCObject 接口提交任务，请求成功后，得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果，根据任务 ID 查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。
流控信息
请求参数
| 字段名称 | 字段详情 |
|---|---|
VideoURLstring | 视频文件 URL 地址。推荐使用上海地域的 OSS 链接，对于文件在本地或者非上海地域 OSS 链接的情况，请参见文件 URL 处理。 示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectVideoIPCObject/DetectVideoIPCObject1.mp4 |
StartTimestampinteger<int64> | 视频实际开始时间的时间戳。例如视频开始时间是 2021 年 8 月 16 日 12:00，对应时间戳为 1629086400。 注意
该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。 示例值:1629086400取值 >= 0 |
CallbackOnlyHasObjectboolean | 是否回调消息过滤。展开详情 示例值:true |
返回参数
| 字段名称 | 字段详情 |
|---|---|
RequestIdstring | 请求 ID。 示例值:35B11E1B-800C-4598-B5AA-577E3BDBD917 |
Messagestring | 提交异步任务后的提示信息。 示例值:该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。 |
Dataobject | 返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用 GetAsyncJobResult 接口，对其 Result 字段进行 JSON 反序列化之后得到。 |
返回说明
查询结果
该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult 。
SDK 参考
阿里云视觉 AI 目标检测类目下的 IPC 视频目标检测能力推荐使用 SDK 调用，支持多种编程语言，调用时请选择 AI 类目为目标检测（objectdet）的 SDK 包，文件参数通过 SDK 调用可支持本地文件及任意 URL，具体可参见 SDK 总览。
示例代码
该能力常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。