ProduceEditingProjectVideo_视频点播_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请确保在使用该接口前,已充分了解视频点播产品的收费方式和价格。云剪辑为付费功能,计费详情,请参见剪辑合成计费

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

  • 云剪辑时间线所使用的视频资源,既可以是素材管理中的素材,也可以是媒体库中的视频,使用媒体库中的视频需要确保其状态为正常(Normal)。

  • 合成视频依据 ProjectId 与 Timeline 进行,具体逻辑如下:

    • ProjectId 与 Timeline 不能同时为空,否则合成视频没有任何依据。
    • 如果 ProjectId 为空,Timeline 不为空,则自动创建一个云剪辑工程,以 Timeline 为时间线,同时提取 Timeline 中引用的素材并设置为云剪辑工程的素材,之后进行视频合成。
    • 如果 ProjectId 不为空,Timeline 为空,则根据 ProjectId 获取最新保存的 Timeline,并以此进行视频合成。
    • 如果 ProjectId 与 Timeline 均不为空,则以传入的 Timeline 为准,进行视频合成,同时更新对应的云剪辑工程(Timeline 和云剪辑工程素材)。如果填写其他字段,则对相应的云剪辑工程字段进行更新。
  • 视频轨、图片轨、字幕轨的轨道数每种均限制最多 100 个。

  • 素材总数不能超过 200 个,素材文件总大小不能超过 1 TB。

  • 输入或输出 Bucket 所在 Region,必须和使用 VOD 服务的 Region 保持一致。

  • 当输出为视频时,成片分辨率有以下限制:

    • 宽高都不能小于 128px。
    • 宽高都不能大于 4096px。
    • 短边不能大于 2160px。
  • 视频合成完成后,会自动上传到视频点播中,因此,视频合成完成之后,点播服务会发送媒体合成完成视频上传完成的事件通知。合成视频转码完成后,会发送视频单个清晰度转码完成视频全部清晰度转码完成的事件通知。

  • 您还可以为合成视频添加特效。更多详情,请参见特效

流控信息

请求速率为50/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
vod:ProduceEditingProjectVideo
Create
全部资源
*

请求参数

字段名称字段详情
ProjectIdstring

云剪辑工程 ID。可通过以下方式获取:展开详情

示例值:fb2101bf24b4cb318787dc****参考取值来源:
    AddEditingProject
    SearchEditingProject
Timelinestring

云剪辑工程时间线,JSON 格式。具体结构定义,请参见 Timeline展开详情

示例值:{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]}
Titlestring

云剪辑工程标题。

示例值:剪辑合成测试
Descriptionstring

云剪辑工程描述。

示例值:描述
CoverURLstring

云剪辑工程封面。

示例值:https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png参考取值来源:
    ListLiveRecordVideo
MediaMetadatastring

合成视频的元数据,JSON 格式。具体结构定义,请参见 MediaMetadata

示例值:{"Description":"合成视频描述","Title":"合成userData测试"}
ProduceConfigstring

合成配置,JSON 格式。具体结构定义,请参见 ProduceConfig展开详情

示例值:{"TemplateGroupId":"6d11e25ea30a4c465435c74****"}
UserDatastring

自定义设置,为 JSON 字符串,支持消息回调等设置。具体结构定义,请参见 UserData展开详情

示例值:{"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}
AppIdstring

应用 ID。默认取值: app-1000000。使用说明,请参见多应用

示例值:app-****参考取值来源:
    ListAppInfo
    CreateAppInfo

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:25818875-5F78-4AF6-D7393642CA58****
MediaIdstring

合成的视频 ID。展开详情

示例值:006204a11bb386bb25491f95f****
ProjectIdstring

云剪辑工程 ID。

示例值:fb2101bf24b4cb318787dc****

返回示例

变更历史

变更时间变更内容概要操作
2023-11-02
新增请求参数AppId

相关示例

将一个或多个视频合成为成品
2022-04-26