You need to enable JavaScript to run this app.
导航
合并回放文件
最近更新时间:2024.01.04 11:49:01首次发布时间:2023.07.10 10:49:15

将多个回放视频合并成一个视频文件,并按需选择是否将其上架至指定直播间。合并后的视频文件存储在媒资库 > 视频库中。您可以通过调用 ListActivityMediaAPI 接口查询合并生成的回放视频。

注意事项

请求频率:单用户请求频率限制为 120 次/分钟

请求说明

  • 请求方式:POST
  • 请求地址:https://livesaas.volcengineapi.com/?Action=MediasMergeAPI&Version=2020-06-01

请求参数

以下请求参数列表仅列出了该接口的部分公共参数,完整公共参数列表见公共请求参数

Query

参数类型是否必选示例值描述
ActionStringMediasMergeAPI接口名称。当前 API 的名称为 MediasMergeAPI
VersionString2020-06-01接口版本。当前 API 的版本为 2020-06-01

Body

参数类型是否必选示例值描述

Vids

Array of String

["vdasdasdag","vdasdasabc"]

待合并的回放视频 Vid 列表。您可以通过 ListMediasAPI 接口查询 Vid。

说明

最多支持合并 10 个视频文件且总时长不可超过 24 小时。

OnlineStatus

Integer

1

是否将合并生成的视频文件上架至指定直播间。若上架,则需要通过 ActivityId 参数指定上架的直播间。默认取值为 0

  • 0:不上架
  • 1:上架

ActivityId

Long

17700853219225

直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。
若合并生成的视频文件需要上架到直播间(即 OnlineStatus 取值为 1),您需要通过该参数指定上架的直播间。

MediaNameString合并文件_202306301230合并生成的视频文件名称。名称默认为:合并文件 + "_" + 年月日 + 时分。

ForceReplayStatus

Boolean

true

在直播状态为预告或已结束时,上架合并生成的视频文件(即 OnlineStatus 取值为 1),是否将直播状态切换为回放。默认取值为 false

  • true:切换,则直播状态切换为回放并播放上架的回放视频。
  • false:不切换,则直播状态不变且不播放上架的回放视频。

返回参数

参数类型示例值描述
MergeTaskIdStringe01039216ede40b0a16462buu7139c03合并任务 ID。返回该 ID,表示已成功将合并任务提交至云剪辑。合并任务完成后,将通过合并回放视频结果回调进行通知。

示例

请求示例

POST https://livesaas.volcengineapi.com/?Action=MediasMergeAPI&Version=2020-06-01
{
  "Vids": [
    "vdasdasdag","vdasdasabc"
  ],
  "ActivityId": 17700853219225,
  "MediaName": "合并文件_202306301230",
  "OnlineStatus": 1,
  "ForceReplayStatus": true
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202306041104200100100232280022D31",
    "Action": "MediasMergeAPI",
    "Version": "2020-06-01",
    "Service": "livesaas",
    "Region": "cn-north-1",
    "SystemTime": 1656067132
  },
  "Result": {
    "MergeTaskId": "e01039216ede40b0a16462buu7139c03"
  }
}

错误码

下表提供了该接口特有的错误码,公共错误码请参见公共错误码错误码文档。

状态码错误码错误信息说明
400InvalidParameter.VidsInvalidThe total video duration exceeds the limit.回放视频总时长超出限制。请修改后重试。
500InternalErrorNo space left in library.媒资库空间不足。