You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
点播间管理
AddVideoRoomMedias - 点播间内添加视频
复制全文
下载 pdf
AddVideoRoomMedias - 点播间内添加视频

调用 AddVideoRoomMedias 接口,在指定点播间中添加视频。

注意事项

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

请求说明

  • 请求方式:POST
  • 请求地址:https://livesaas.volcengineapi.com/?Action=AddVideoRoomMedias&Version=2023-08-01

调试

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringAddVideoRoomMedias接口名称。当前 API 的名称为 AddVideoRoomMedias
VersionString2023-08-01接口版本。当前 API 的版本为 2023-08-01

Body

参数类型是否必选示例值描述
VideoRoomIdInteger20001点播间的 ID。您可通过调用 ListVideoRooms 接口获取 ID。
VideoVidsArray of VideoVids-点播间视频列表。

VideoVids

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

Vid

String

v02a49g10000ck****3c77u8uhf09ebg

视频的 ID。您可通过调用 ListActivityMediaAPI 接口获取 Vid。

说明

使用子账号调用接口时,确保视频对子账号可见。有关如何配置子账号的可见范围,详见子账号管理

NameString第一章视频名称。
VodCoverImgStringhttps://example.com/vod-cover-1.jpg当前视频的横屏封面图的 URL。需包含协议头。建议图片比例为 16:9,支持上传格式为 JPG、PNG 和 JPEG 的图片。图片大小不超过 2 MB。

返回参数

参数类型示例值描述
StatusBooleantrue是否成功添加。成功返回 true

请求示例

POST https://livesaas.volcengineapi.com/?Action=AddVideoRoomMedias&Version=2023-08-01
{
    "VideoRoomId": 20001,
    "VideoVids": [
        {
            "Vid": "v_demo_001",
            "Name": "课程视频1",
            "VodCoverImg": "https://example.com/vod-cover-1.jpg",
            "MediaLibraryVideoId": 90001
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "AddVideoRoomMedias",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "Status": true
    }
}

错误码

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

最近更新时间:2026.06.24 11:45:18
这个页面对您有帮助吗?
有用
有用
无用
无用