TempToMediaActivityMediaAPI - 直播暂存转存视频库--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

TempToMediaActivityMediaAPI - 直播暂存转存视频库

最近更新时间：2025.03.24 16:50:54首次发布时间：2022.07.29 11:52:45

通过本接口，您可以将直播暂存中的视频转存至视频库中的指定分类下，并进行永久存储，同时该视频将从直播暂存中删除。

注意事项

请求频率：单用户请求频率限制为 120 次/分钟。
前提条件：确保您拥有火山引擎主账号或具备媒资库 > 视频管理 > 直播暂存 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。

请求说明

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

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`TempToMediaActivityMediaAPI`	接口名称。当前 API 的名称为 `TempToMediaActivityMediaAPI`。
Version	String	是	`2020-06-01`	接口版本。当前 API 的版本为 `2020-06-01`。

Body

参数	类型	是否必选	示例值	描述
Ids	Array of String	是	`["409144","409154"]`	待转存视频的 ID。您可以通过 ListActivityMediaAPI 接口查询 ID，即返回参数中的 `Id`。说明最多支持配置 100 个 ID。使用子账号调用接口时，确保视频对子账号可见。有关如何配置子账号的可见范围，详见子账号管理。
FolderId	Long	否	`48921`	分类 ID，即将视频转存到该分类下。默认取值为 `0`，表示将视频转存到默认分类下。您可以通过 GetVideoLibraryFolderTree 接口获取 ID。说明使用子账号调用接口时，确保分类对子账号可见。有关如何配置子账号的可见范围，详见子账号管理。

返回参数

参数类型示例值描述

参数	类型	示例值	描述
Success	Boolean	`false`	视频是否转存成功。 `true`：成功，即所有视频均转存成功。 `false`：失败，即存在一个或多个视频转存失败。
FailedList	Array of FailedList	`-`	转存失败的视频列表。仅当存在转存失败的视频（即 `Success` 取值为 `false`）时，返回该列表。

Success

Boolean

false

视频是否转存成功。

true：成功，即所有视频均转存成功。
false：失败，即存在一个或多个视频转存失败。

FailedList Array of FailedList - 转存失败的视频列表。仅当存在转存失败的视频（即 Success 取值为 false）时，返回该列表。

FailedList

参数	类型	示例值	描述
Id	String	`409144`	视频 ID。
Name	String	`视频1`	视频名称。

请求示例

POST https://livesaas.volcengineapi.com/?Action=TempToMediaActivityMediaAPI&Version=2020-06-01
{
    "Ids": [
        "409144",
        "409154"
    ],
    "FolderId": 1795946215298105
}

返回示例

{
  "ResponseMetadata":{
    "RequestId": 20230807162855279B3985D4AD7526EA08,
    "Action": "TempToMediaActivityMediaAPI",
    "Version": "2020-06-01",
    "Service": "livesaas",
    "Region": "cn-north-1",
    "SystemTime": 1656067132
  }
  "Result":{
    "Success": false,
    "FailedList": [
      {
        "Id": "409144",
        "Name": "视频1"
      }
    ]
  }
}

错误码

访问公共错误码和错误码获取详细信息。