AddCustomLiveStreamTranscode - API Reference| Alibaba Cloud Documentation Center

Description

Add custom transcode configuration information.

Request parameter

Parameters	Type	Required	Example values	Description
Action	String	Yes	AddCustomLiveStreamTranscode	The name of this interface. Value: AddCustomLiveStreamTranscode
App	String	Yes	AppName	Name of the app, which the live stream belongs to. Value requirement: number, upper case letters, lower case letters, underline (_), or hyphen (-).
Domain	String	Yes	live.aliyunlive.com	Your CDN domain name.
FPS	Integer	Yes	30	Transcode video frame per second. Unit: fps. Value requirement: [1, 30]
Height	Integer	Yes	720	Transcode video width. Value requirement: Width ≥ 100 max(Height, Width) ≤ 1920 min(Height, Width) ≤ 1080
Template	String	Yes	LDtest	Transcode template custom name. Value requirement: number, upper case letters, lower case letters, or hyphen (-). Note: This name and the standard transcode template are not the same.
TemplateType	String	Yes	h264	Custom trascode template type. Currently, only suppports: h264-nbhd (custom H264 narrowband high-definition template) not supports: h264 (custom H264 standard template).
VideoBitrate	Integer	Yes	720	Transcode video bit rate, unit: kbps. Value requirement: [1, 6000] Note: transoded video approximates the bit rate you set as much as possible, but not actually the same, especially when the bit rate you set is much too higher or lower.
Width	Integer	Yes	576	Transcode video width. Value requirement: Width ≥ 100 max(Height, Width) ≤ 1920 min(Height, Width) ≤ 1080
Version	String	No	1.0	Version.

Return parameter

Parameters	Type	Example values	Description
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	The ID of the job request.

Example

Return example

https://live.aliyuncs.com?Action=AddCustomLiveStreamTranscode&Domain=test101.cdnpe.com&App=AppName&Template=LDtest&TemplateType=h264&Height=1280&Width=720&FPS=25&VideoBitrate=2400&<public request parameter>

Normal return example

JSON format

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

Exception return example

JSON format

{
    "Code":"InternalError",
    "HostId":"live.aliyuncs.com",
    "Message":"The request processing has failed due to some unknown error.",
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error code

For more information about error code of this product, see Error code.