调用CreateVideoAnalyseTask接口创建一个视频分析任务,执行完成后返回TaskId。

接口说明

执行完成后,使用GetVideoTask接口查询调用CreateVideoAnalyseTask接口后返回的TaskId,可以查看任务执行结果。您也可以使用通知机制,传入NotifyTopicName和NotifyEndpoint,及时获取任务执行信息。

调试

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

请求参数

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

操作接口名称,固定取值为CreateVideoAnalyseTask。

Project String immvideotest

项目名称。

VideoUri String oss://imm-test/testcases/video.mp4

视频的OSS URI。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

TgtUri String oss://imm-test/testcases

输出文件的OSS URI。

输出文件保存位置如下:

  • 视频帧存放在imgs路径。
  • 语音在audio路径。
  • 结果存放在result/result.txt。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

NotifyTopicName String topic1

异步反向通知的TopicName。

NotifyEndpoint String http://1111111111.mns.cn-hangzhou.aliyuncs.com

异步反向通知的Endpoint,任务执行状态可以通过该Endpoint异步通知给调用者。使用此功能需要先开通MNS服务,新建topic和queue,并配置订阅关系。具体操作,请参见消息服务MNS快速入门

说明 MNS服务和智能媒体管理必须处于同一地域。

返回数据

名称 类型 示例值 描述
RequestId String 9D129100-FB5F-4243-AD33-DD1D49C8A6D2

当次请求的Request ID。

TaskId String VideoAnalyseTask-c091c3f5-e6a5-46ce-a0f2-454bd779f3e7

任务ID。

TaskType String VideoAnalyseTask

任务的类型,返回值固定为VideoAnalyseTask。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateVideoAnalyseTask
&Project=immvideotest
&VideoUri=oss://imm-test/testcases/video.mp4
&<公共请求参数>

正常返回示例

XML格式

<TaskId>VideoAnalyseTask-c091c3f5-e6a5-46ce-a0f2-454bd779f3e7</TaskId>
<RequestId>9D129100-FB5F-4243-AD33-DD1D49C8A6D2</RequestId>
<TaskType>VideoAnalyseTask</TaskType>

JSON格式

{
    "TaskId": "VideoAnalyseTask-c091c3f5-e6a5-46ce-a0f2-454bd779f3e7",
    "RequestId": "9D129100-FB5F-4243-AD33-DD1D49C8A6D2",
    "TaskType": "VideoAnalyseTask"
}