SubmitLiveEditingJob - 提交直播剪辑任务

将一个或多个直播流区间合成为成品。提交直播剪辑任务后,任务将进入后台排队,异步执行。提交后可以调用查询直播剪辑作业(GeLiveEditingJob )接口根据 jobId 来查询作业状态。 也可调用获取媒资内容信息(GetMediaInfo)接口根据 MediaId 来查询生成媒资的信息。

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Clipsstring

剪辑片段列表,输出的成片由列表中的片段按顺序收尾拼接而成。JSON 数组格式。每一个片段都包含开始时间和结束时间。如果没有直播流参数,则以外层的直播流配置为准。开始和结束时间戳皆为UTC时间。参数详情请见下方 Clip 数据结构。

[{\"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****
LiveStreamConfigstring

直播流配置 AppName: 播流所属应用名称 DomainName: 域名 StreamName: 直播流名

{ "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
OutputMediaConfigstring

输出成品的目标配置,Json格式。可以设置输出成品的在OSS 上的URL,或者VOD Bucket 中的存储位置。 输出到OSS时,输出目标的 MediaURL 必填;输出到VOD 时,StorageLocation 和 FileName 两个参数必填。

{ "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, 或 { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
MediaProduceConfigstring

生成片段的合成配置,json string

"Mode": 剪辑模式,默认模式 "AccurateFast" 快速精剪

- "Accurate": 精确剪辑,可指定输出成片宽高。

- "AccurateFast": 快速精剪,相较于Accurate模式合成速度更快。输出文件与源流分辨率一致,不支持指定输出成片宽高。

- "Rough": 粗略剪辑,最小精度为一个ts分片,成片包含用户指定起止时间内所有分片。可指定输出成片宽高。

- "RoughFast": 快速粗剪,相较于Accurate模式合成速度更快,最小精度为一个ts分片,成片包含用户指定起止时间内所有分片。输出文件与源流分辨率一致,不支持指定输出成片宽高。

{ "Mode": "AccurateFast"}
UserDatastring

自定义设置,Json格式,长度限制为512字节。

{"key": "value"}
OutputMediaTargetstring

输出成品的目标类型。取值:

  • oss-object 阿里云oss bucket下的oss object
  • vod-media 阿里云vod的媒资
oss-object 或 vod-media

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。

返回参数

名称类型描述示例值
object

Schema of Response

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****

示例

正常返回示例

JSON格式

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

错误码

访问错误中心查看更多错误码。

阿里云首页 智能媒体生产 相关技术圈