You need to enable JavaScript to run this app.
导航
MediasMergeAPI - 合并回放视频
最近更新时间:2025.03.24 16:50:55首次发布时间:2023.07.10 10:49:15
我的收藏
有用
有用
无用
无用

调用 MediasMergeAPI 接口,将多个回放视频合并成一个视频文件,并按需选择是否将其上架至指定直播间。合并后的视频文件归属于调用接口的主账号或子账号,并存储在媒资库下的视频库中。您可以通过调用 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

["vdas**sdag","vdas**sabc"]

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

说明

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

OnlineStatus

Integer

1

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

  • 0:不上架
  • 1:上架

ActivityId

Long

17700****19225

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

说明

使用子账号调用接口时,确保该直播间对子账号可见且子账号具备回放管理 > 可编辑权限。有关如何配置子账号的可见范围和权限,详见子账号管理

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

ForceReplayStatus

Boolean

true

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

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

返回参数

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

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "MediasMergeAPI",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "MergeTaskId": "e01039216ede40****6462buu7139c03"
    }
}

错误码

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

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