全部产品
Search

搜索本产品

    智能媒体服务：CreateLivePackageChannel - 创建实时打包频道

    文档中心

    智能媒体服务：CreateLivePackageChannel - 创建实时打包频道

    更新时间：Jan 14, 2026

    生成实时视频流处理频道，支持HLS协议，自动分配端点和密钥。

    接口说明

    请求说明

    该接口用于创建一个实时视频打包服务频道，目前支持 HLS 协议。系统将自动生成输入端点地址及认证所需的用户名和密码。

    注意事项

    • 频道组名称与频道名称只能包含大小写字母、数字、下划线和短横线。
    • 协议目前仅支持HLS。
    • 切片时长需设置在 1 至 30 秒之间。
    • m3u8 切片个数需在 2 至 100 个之间。

    成功响应将返回新创建频道的详细信息，包括通道名、创建时间、修改时间、输入端点详情等。

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用前面加 * 表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    ice:CreateLivePackageChannelcreate
    *全部资源
    *
      无
    		无

    请求参数

    名称类型必填描述示例值
    GroupNamestring是

    频道组名称，字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式：[A-Za-z0-9_-]+

    		channel-group-1
    SegmentCountinteger是

    输入流 m3u8 切片个数，2～100

    		3
    Descriptionstring否

    描述，最大 1000 个字符

    		这是一个测试频道
    SegmentDurationinteger是

    输入流切片时长，1～30

    		6
    ChannelNamestring是

    频道名称，字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式：[A-Za-z0-9_-]+

    		channel-1
    ClientTokenstring否

    幂等参数

    		****12e8864746a0a398****
    Protocolstring是

    输入协议，目前仅支持 HLS

    		HLS

    返回参数

    名称类型描述示例值
    object

    Schema of Response

    LivePackageChannelobject

    实时打包频道的具体信息

    ChannelNamestring

    频道名称

    		example-channel
    CreateTimestring

    格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）

    		2023-04-01T12:00:00Z
    Descriptionstring

    描述

    		这是一个测试频道
    GroupNamestring

    频道组名称

    		channel-group-1
    IngestEndpointsarray<object>

    输入端点

    ingestEndpointobject

    输入端点 URL

    Idstring

    输入端点 ID

    		ingest1
    Passwordstring

    密码

    		2F9e******b569c8
    Urlstring

    输入端点 URL

    		http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest
    Usernamestring

    用户名

    		us12******das
    LastModifiedstring

    格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）

    		2023-04-01T12:00:00Z
    Protocolstring

    输入协议，HLS

    		HLS
    SegmentCountinteger

    输入流 m3u8 切片个数

    		3
    SegmentDurationinteger

    输入流切片时长

    		5
    RequestIdstring

    请求 ID

    		******3B-0E1A-586A-AC29-742247******

    示例

    正常返回示例

    JSON格式

    {
  "LivePackageChannel": {
    "ChannelName": "example-channel",
    "CreateTime": "2023-04-01T12:00:00Z",
    "Description": "这是一个测试频道",
    "GroupName": "channel-group-1",
    "IngestEndpoints": [
      {
        "Id": "ingest1",
        "Password": "2F9e******b569c8",
        "Url": "http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
        "Username": "us12******das"
      }
    ],
    "LastModified": "2023-04-01T12:00:00Z",
    "Protocol": "HLS",
    "SegmentCount": 3,
    "SegmentDuration": 5
  },
  "RequestId": "******3B-0E1A-586A-AC29-742247******"
}

    错误码

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