全部产品
云市场

视频合成

更新时间:2019-08-21 20:18:16

描述

将一个或多个视频合成为成品。可以通过时间线参数直接提交源视频,也可以先创建云剪辑工程,再提交合成。

注意:该接口返回合成任务的提交结果,不保证接口返回时视频已合成完毕。合成任务将进入后台排队,异步执行。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数。取值: ProduceEditingProjectVideo
ProjectId String 云剪辑工程Id
Timeline String 云剪辑工程时间线,Json格式。具体结构定义参见 Timeline
Title String 云剪辑工程标题
Description String 云剪辑工程描述
CoverURL String 云剪辑工程封面
MediaMetadata String 合成视频的元数据,Json格式。具体结构定义参见 MediaMetadata
ProduceConfig String 合成配置,Json格式。具体结构定义参见 ProduceConfig
UserData UserData[] 自定义设置,为JSON字符串,支持消息回调等设置。

说明:

  • 云剪辑时间线所使用的视频资源,既可以是素材管理中的素材,也可以是媒体库中的视频。
  • 合成视频依据ProjectId与Timeline进行,具体逻辑如下:
    • ProjectId与Timeline不能同时为空,否则合成视频没有任何依据。
    • 如果ProjectId为空,Timeline不为空,则自动创建一个云剪辑工程,以Timeline为时间线,同时提取Timeline中引用的素材并设置为云剪辑工程的素材,之后进行视频合成。
    • 如果ProjectId不为空,Timeline为空,则根据ProjectId获取最新保存的Timeline,并以此进行视频合成。
    • 如果ProjectId与Timeline均不为空,则以传入的Timeline为准,进行视频合成,同时更新对应的云剪辑工程(Timeline和云剪辑工程素材)。如果填写其他字段,则对相应的云剪辑工程字段进行更新。
  • 特效(Effect)参数一览表

返回参数

名称 类型 描述
RequestId String 请求Id
MediaId String 合成的视频Id

说明:

  • 视频合成接口同步返回合成的视频ID。
  • 接口返回MediaId,表示视频合成已进入异步处理阶段。
  • 与视频上传类似,视频合成完成之后,点播服务会发送“视频上传完成”的事件通知。合成视频转码完成后,会发送“视频单个清晰度转码完成”通知和“视频全部清晰度转码完成”通知。

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=ProduceEditingProjectVideo&ProjectId=fb2101bf24bf41c78b2754cb318787dc&Format=JSON&<公共参数>

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "MediaId": "006204a11bb340d6b7f86bb25491f95f"
  4. }

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: