调用AddCustomLiveStreamTranscode添加自定义转码配置信息。

使用说明

本接口目前支持以下自定义转码模版类型，取值：

  • h264：自定义H264标准模版。
  • h264-nbhd：自定义H264窄带高清™模版。
  • h265：自定义H265标准模版。
  • h265-nbhd：自定义H265窄带高清模版。
  • audio：纯音频模板。

QPS限制

本接口的单用户QPS限制为6000次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 AddCustomLiveStreamTranscode

系统规定参数。取值：AddCustomLiveStreamTranscode。

App String 是 liveApp****

播流所属应用名称。
Domain String 是 example.com

主播流域名。
Template String 是 LiveCusTranscode****

转码模板自定义名称。

说明 必须由数字、大小写字母或短横线（-）组成，且字段必须以大小写字母或数字开头，不能与标准的转码模板命名重复。
TemplateType String 是 h264

自定义转码模版类型。取值：

  • h264：自定义H264标准模版。
  • h264-nbhd：自定义H264窄带高清™模版。
  • h265：自定义H265标准模版。
  • h265-nbhd：自定义H265窄带高清模版。
  • audio：纯音频模板。
RegionId String 否 cn-shanghai

地域ID。
KmsKeyID String 否 afce5722-81d2-43c3-9930-7601da11****

用户KMS主密钥ID。
KmsUID String 否 25346073170691****

用户KMS主账号ID。
KmsKeyExpireInterval String 否 3600

换Key周期。取值范围：60~3600，单位：秒。
Height Integer 否 720

转码视频高度。取值：

  • Height ≥ 100
  • max（Height,Width）≤ 2560
  • min（Height,Width）≤ 1440
注意 265窄带高清模板不得超过1280×720。
Width Integer 否 576

转码视频宽度。取值：

  • Width ≥ 100
  • max（Height,Width）≤ 2560
  • min（Height,Width）≤ 1440
注意 265窄带高清模板不得超过1280×720。
FPS Integer 否 30

转码视频帧率。单位：FPS，取值：1~60。

VideoBitrate Integer 否 720

转码视频比特率。单位：kbps，取值：1~6000。

说明 转码视频会尽量接近您所设定的比特率，但转码视频的实际比特率不能保证和您所设定的完全一致，尤其是当您设定的比特率过大或过小时。
AudioBitrate Integer 否 512

转码音频比特率。单位：Kbps，取值：1~1000。

Gop String 否 1

视频GOP（Group of Picture）。单位：帧，取值：1~3000。

Profile Integer 否 2

编码级别。视频支持的一组特定的编码功能，一般值越大得到的画面质量越好，同时编解码消耗的资源也越高。取值：

  • 1：baseline（适合移动设备）。
  • 2：main（适合标准分辨率设备）。
  • 3：high（适合高分辨率设备）。
AudioProfile String 否 aac_low

音频编码。取值：

  • aac_low
  • aac_he
  • aac_he_v2
  • aac_ld
AudioCodec String 否 AAC

音频编码格式。取值：

  • AAC
  • MP3
AudioRate Integer 否 96000

音频采样率。取值：22050~96000。

注意 如果AudioProfile取值为aac_ld，则采样率不能超过44100。
AudioChannelNum Integer 否 2

音频声道数。取值

  • 1：单声道。
  • 2：双声道。
EncryptParameters String 否 {"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}

加密配置。JSON格式，各字段说明如下：

  • EncryptType：加密类型。固定取值aliyun。
  • KmsKeyID：用户KMS主密钥ID。
  • KmsKeyExpireInterval：换Key周期。取值范围：60~3600，单位：秒。

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddCustomLiveStreamTranscode
&App=liveApp****
&Domain=example.com
&Template=LiveCusTranscode****
&TemplateType=h264
&<公共请求参数>

正常返回示例

XML格式 

<AddCustomLiveStreamTranscodeResponse>
	  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddCustomLiveStreamTranscodeResponse>

JSON格式 

{
    "AddCustomLiveStreamTranscodeResponse": {
        "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    }
}

错误码

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