全部产品
云市场

CreateVideoAbstractTask

更新时间:2019-09-19 15:33:02

描述

创建一个视频摘要的任务。该任务需要一个视频类型的 project,目前为 VideoCompressStarter / VideoCompressProfessional。

请求参数

名称 类型 是否必填 描述
Project string Project
Action String CreateVideoAbstractTask
VideoUri String 视频 Uri
OSS 地址规则为:oss://bucket/object,其中 bucket和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。
TargetVideoUri String 视频摘要存储地址,和TargetClipsUri必须设置一个,可以两个都设置
TargetClipsUri String 视频摘要时间片存储地址和TargetVideoUri必须设置一个,可以两个都设置
AbstractLength Integer 视频摘要时长,生成的摘要时长会略有偏差
NotifyTopicName String 异步通知的 TopicName
NotifyEndpoint String 异步反向通知的 Endpoint,作业处理状态可以通过该 Endpoint 异步通知到调用者

关于 MNS 的使用方式,参考 消息服务 MNS 概述

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
TaskId String 该任务对唯一 ID
TaskType String Task 所属类型,固定值 VideoAbstractTask

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=CreateVideoAbstractTask
  3. &Project=test
  4. &VideoUri=oss://xxx/test/res.mp4
  5. & TargetVideoUri =oss://xxx/test/abstract.mp4
  6. & AbstractLength =240

成功返回示例

  1. {
  2. "RequestId": "10AFFE69-73BA-47C2-8A85-029AA9DA72A3",
  3. "TaskId": "VideoCompressTask-ffcdec0c-73ba-451a-bec4-a9fe3f4cd765",
  4. "TaskType": "VideoAbstractTask"
  5. }

订阅消息返回示例

MNS 返回的消息格式如:

  1. {
  2. "events": [
  3. {
  4. "eventName": "VideoAbstractTask",
  5. "eventSource": "acs:imm",
  6. "eventTime": "2019-09-17T08:06:47.276Z",
  7. "eventVersion": "1.0",
  8. "imm": {
  9. "JobId": "VideoAbstractTask-b95d7d1b-a9c0-447b-b614-4ac135d04044",
  10. "Results": "{\"VideoUri\":\"oss://xxx/test/res.mp4\",\"TimeClips\":[[41.25,61.25]],\"TargetVideoUri\":\"oss://xxx/test/abstract.mp4\",\"SourceResolution\":\"1280x720\",\"SourceCodec\":\"h264\",\"SourceDuration\":\"412.50\",\"ProcessDuration\":\"117\"}"
  11. }
  12. }
  13. ]
  14. }

若在使用中有疑问,请参考 FAQ,或者进入 钉钉用户群 实时交流。