调用EditShowAndReplace添加剪辑任务。

使用说明

本接口支持指定CasterId和ShowId添加剪辑任务。

添加剪辑任务成功不会自动通知,您可调用GetEditingJobInfo接口查询任务状态信息。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String EditShowAndReplace

系统规定参数。取值:EditShowAndReplace

CasterId String 53200b81-b761-4c10-842a-a0726d97****

导播台ID。

  • 如果您通过CreateCaster接口创建导播台,请查看CreateCaster接口调用返回的参数CasterId值。
  • 如果您通过直播控制台创建导播台,请通过直播控制台 > 导播台 > 云导播台页面查看。
说明 直播控制台云导播台页面导播台列表中的导播台名称即导播台ID。
ShowId String 42200b81-b761-4c10-842a-a0726d97****

需要剪辑的节目ID。

说明 通过查看AddShowIntoShowList接口的返回参数获取ShowId值。
UserData String 900a2b2r8-13c2-****-88f2-75e4a07c1ed9

用户信息。

StorageInfo String { "StorageLocation":"***bucket***", "FileName":"EditFile****.mp4" }

存储信息。描述:

  • StorageLocation:用户点播存储地址。
  • FileName:用户自定义文件名。
说明 剪辑存储地址必须是用户同一账户下的点播存储地址,获取点播存储地址请参见存储管理
StartTime Float 2.0

剪辑开始时间,单位:秒。

说明
  • 剪辑时间取值范围为0到节目总时长。
  • 默认从点播文件开头开始剪辑,取值:0.0。
  • 如果您想要剪辑一个点播文件,从第2秒到第5秒,那么StartTime取值为2.0,EndTime取值为5.0。
EndTime Float 5.0

剪辑结束时间,单位:秒。

说明
  • 剪辑时间取值范围为0到节目总时长。
  • 默认取值为点播文件结束时长,取值不可超出节目的总时长。
  • 如果您想要剪辑一个点播文件,从第2秒到第5秒,那么StartTime取值为2.0,EndTime取值为5.0。

返回数据

名称 类型 示例值 描述
JobInfo String { "vodId": "3e34733b40b9a96ccf5c1ff6f69****", "mediaid": "eb1861d2c9a842340e989dd56****", "jobId": "7d2fbc380b0e08e55fe98733764****" }

任务信息,包含:

  • vodId:点播文件ID。
  • mediaid:媒体文件ID。
  • jobId:任务ID。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=EditShowAndReplace
&CasterId=53200b81-b761-4c10-842a-a0726d97****
&ShowId=42200b81-b761-4c10-842a-a0726d97****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<EditShowAndReplaceResponse> 
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<JobInfo>
    <vodId>3e34733b40b9a96ccf5c1ff6f69****</vodId>
    <mediaid>eb1861d2c9a842340e989dd56****</mediaid>
    <jobId>7d2fbc380b0e08e55fe98733764****</jobId>
</JobInfo>
</EditShowAndReplaceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "JobInfo" : {
    "vodId" : "3e34733b40b9a96ccf5c1ff6f69****",
    "mediaid" : "eb1861d2c9a842340e989dd56****",
    "jobId" : "7d2fbc380b0e08e55fe98733764****"
  }
}

错误码

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