SubmitLiveEditingJob
直播剪辑指将一个或多个直播流区间合成为成品。提交直播剪辑任务后，任务将进入后台排队，异步执行。提交后可以调用查询直播剪辑作业（GeLiveEditingJob ）接口根据 jobId 来查询作业状态。 也可调用获取媒资内容信息（GetMediaInfo）接口根据 MediaId 来查询生成媒资的信息
服务地址：
华东1（杭州）
输入参数
只看必填
Clips剪辑片段列表
ProjectId直播剪辑工程ID
LiveStreamConfig直播流配置
OutputMediaConfig输出成品的目标配置
MediaProduceConfig生成片段的合成配置
UserData自定义设置
OutputMediaTarget输出成品的目标类型
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

当前支持对录制到 OSS 和 VOD 的直播流进行直播剪辑。多直播流混剪时，仅支持直播流都录制到 OSS 或直播流都录制到 VOD。

请求参数

字段名称字段详情
Clipsstring

剪辑片段列表，输出的成片由列表中的片段按顺序收尾拼接而成，JSON Array。展开详情

示例值:[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
ProjectIdstring

直播剪辑工程 ID。若非空，读取 project 相关存储配置。 若为空，则以入参存储配置为准。

示例值:****fddd7748b58bf1d47e95****参考取值来源:
    ListEditingProjects
    SearchEditingProject
    CreateEditingProject
    GetProjectExportJob
    AddEditingProjectMaterials
LiveStreamConfigstring

直播流配置， JSON Object。需包含如下配置项：展开详情

示例值:{ "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }参考取值来源:
    GetLiveEditingJob
OutputMediaConfigstring

输出成品的目标配置，JSON Object。可以设置输出成品的在 OSS 上的 URL，或者 VOD Bucket 中的存储位置。展开详情

示例值:{ "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, 或 { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }参考取值来源:
    SubmitMediaProducingJob
MediaProduceConfigstring

生成片段的合成配置，用 JSON 格式表示。其中，Mode 为剪辑模式，取值：展开详情

示例值:{ "Mode": "AccurateFast"}
UserDatastring

自定义设置，JSON Object，长度限制为 512 字节。

示例值:{"key": "value"}
OutputMediaTargetstring

输出成品的目标类型。取值：展开详情

示例值:oss-object

请求说明

Clip 数据结构

属性名类型示例值描述是否必填
StartTimeString2021-06-21T08:01:00Z截取片段的开始时间，格式为 UTC 时间戳是
EndTimeString2021-06-21T08:05:00Z截取片段的结束时间，格式为 UTC 时间戳是
AppNameStringapp播流所属应用名，如果为空，以外层直播流配置为准否
DomainNameStringdomain.com域名 ，如果为空，以外层直播流配置为准否
StreamNameStringstream直播流名，如果为空，以外层直播流配置为准否
CoverTimeString2021-06-21T08:03:00Z指定片段中的某一时间戳，作为成片的封面图，格式为 UTC 时间戳 。当多个 clip 都设置 CoverTime 参数时，仅第一个生效，CoverTime 必须大于等于 StartTime，小于等于 Endtime。否
CoverUrlStringhttps://test.oss-cn-shanghai.aliyuncs.com自定义截图输出地址, OSS bucket 需与服务接入区域保持一致。仅支持自有 OSS bucket，不支持 VOD 托管 bucket。否

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:****36-3C1E-4417-BDB2-1E034F****
ProjectIdstring

直播剪辑工程 ID。

示例值:****fddd7748b58bf1d47e95****
JobIdstring

直播剪辑任务 ID。

示例值:****d80e4e4044975745c14b****
MediaIdstring

合成成片媒资 ID。

示例值:****c469e944b5a856828dc2****
MediaURLstring

合成成片地址。

示例值:http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
VodMediaIdstring

如果视频输出的位置为 vod 时，返回 vod 媒资 ID。

示例值:****d7578s4h75ci945c14b****
变更历史
变更时间变更内容概要操作
2022-09-22
变更请求参数Clips
变更返回参数
2021-08-13
新增OpenAPI，提交直播剪辑任务