All Products
Search
Document Center

ApsaraVideo VOD:Transcoding templates

Last Updated:Nov 07, 2024

ApsaraVideo VOD allows you to save complex parameter configurations as transcoding templates. This way, you can use a transcoding template or workflow to submit transcoding tasks. Each transcoding template has a unique ID. A transcoding template group can contain multiple transcoding templates. This topic describes how to create and use different types of transcoding templates.

Transcoding template types

In most cases, transcoding parameters are complex. To free you from complicated parameter management, ApsaraVideo VOD allows you to save complex parameter configurations as templates. You can create custom transcoding templates. A custom transcoding template contains a set of transcoding parameters such as audio parameters, video parameters, and container parameters to meet your custom requirements for transcoding. In a transcoding template group, you can define multiple output settings. ApsaraVideo VOD provides recommended parameter settings based on the video definition and audio quality to allow you to transcode videos without the need to learn the technical details.

Type

Source

Scenario

Description

Regular Transcoding Template

User-defined

  • Regular transcoding

  • Audio transcoding

  • Container format conversion

  • Narrowband HD™ transcoding

  • You can use Narrowband HD™ 1.0 transcoding to export videos only in the HTTP Live Streaming (HLS) or MP4 format.

  • You can use Narrowband HD™ 2.0 transcoding to export videos only in the MP4 format.

Video Packaging Template

User-defined

Adaptive bitrate (ABR) streaming

You can use ABR streaming to export videos only in the HLS format, which are M3U8 playlists that consist of TS segments.

No Transcoding

Built-in

Distribution without transcoding

When you use the No Transcoding template group, make sure that the source files are in the MP4, Flash Video (FLV), M3U8, MP3, or WebM formats and can be directly played. For a video, the codec must be H.264 or H.265. If you have videos from multiple sources and are uncertain about their codecs, we recommend that you transcode the videos before you play them. Take note that WebM videos are encoded in VP8 or VP9 and require a corresponding playback client.

Usage notes

  • You are charged based on the transcoding specifications that you configured in the transcoding template. In some cases, the specifications in the transcoding template are different from those based on which you are billed. For more information, see Billing of basic services.

  • After you activate ApsaraVideo VOD, the No Transcoding template group is used by default. You cannot modify or delete the No Transcoding template group. If you use the No Transcoding template group for videos in the MP4, FLV, M3U8, MP3, or WEBM formats, the URLs of your videos in original quality are used for playback. If you use the No Transcoding template group for videos in other formats, the videos are considered source files and cannot be played.

  • To avoid transcoding failures, do not modify or delete a template or a template group when a transcoding job is in progress.

Limits

You can create up to 20 transcoding template groups in each region. You can add up to 10 regular transcoding templates and 10 video packaging templates to a transcoding template group.

Create a transcoding template group

Important

After you submit a transcoding job, the video is transcoded based on all transcoding templates in the transcoding template group. In this case, you are charged for all transcoded video files. To prevent unnecessary costs, add transcoding templates based on your business requirements.

The video-on-demand transcoding template group has been upgraded and is gradually released in gray scale. If you find that the current version does not match the documentation, it may not have been updated. Please submit a ticket so that we can help you switch to the latest version.

Use the ApsaraVideo VOD console

Regular transcoding

  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Configuration Management > Media Processing > Transcoding Template Groups.

  3. In the top navigation bar, select the desired region from the drop-down list next to the Workbench button.

  4. On the Transcoding Template Groups page, click Create Transcoding Template Group.

  5. In the Regular Transcoding Template section, click Add Template and configure the parameters. The following table describes the parameters.

    Note

    For more information about the parameters, see Create a transcoding template.

    普通转码-国际站

    No.

    Category

    Parameter

    Description

    1

    Basic Parameters

    Transcoding Type

    • Valid values: Regular Transcoding, Audio Transcoding, Container Format Conversion, Narrowband HD™ 1.0, and Narrowband HD™ 2.0. In this section of the topic, set the value to Regular Transcoding.

    Note

    • For detailed information about specifications of Narrowband HD™ 1.0, such as SD-Narrowband HD™ 1.0, see Narrowband HD™ transcoding.

    • If you set Definition to Original, the original definition and bitrate of videos are retained. Only the container format of videos is modified. This is suitable for scenarios in which you do not need to change the size or bitrate of videos.

    • For audio, the audio quality can be Standard Quality or High Quality.

    Encapsulation Format

    • Valid values for videos: HLS, MP4, and FLV.

    • Valid values for audio: MP3 and AAC.

    For more information about each container format, see Terms.

    2

    Video Parameters

    Disable Video

    If you select Disable Video, the transcoded output does not contain video information. You can select Disable Video to extract audio in scenarios such as radio broadcasts.

    Encoding Format

    Valid values: H.264 and H.265.

    Resolution

    • Preset Resolution: LD, SD, HD, Ultra HD, 2K, and 4K. The width is 640 to 3,480 pixels, and the height is adapted to the width.

    • If you select Set by Long and Short Sides or Set by Width and Height, enter corresponding values from 128 to 4,096 pixels.

    • If you want the screen to be automatically adapted, specify only one of the two values.

    Video Bitrate

    Valid values: 600 (for H.264) and 300 (for H.265). Unit: Kbit/s.

    Frame Rate

    • The number of frames displayed per second. We recommend that you use the recommended value.

    • Valid values: 0 to 60. Frame rates of 24 FPS, 25 FPS, and 30 FPS are commonly used.

    Maximum Keyframe Interval

    The number of frames in a group of pictures (GOP). We recommend that you use the recommended value.

    Watermark

    Specifies whether to add a watermark to a video. To add a watermark to a video, you must configure and enable a watermark template. For more information, see Video watermarks.

    3

    Audio Parameters

    Disable Audio

    If you select Disable Audio, the transcoded output does not contain audio information. If you want to generate a video with no sound, select Disable Audio.

    Encoding Format

    If you set Encapsulation Format to HLS or MP4, you can set this parameter to AAC or MP3. If you set Encapsulation Format to MP3, you can set this parameter only to MP3.

    Sample Rate

    We recommend that you use the recommended value.

    Bitrate (Kbps)

    Valid values: 8 to 1000. We recommend that you use the recommended value.

    Audio Channels

    We recommend that you use the recommended value.

    4

    Advanced Parameters (available only when you set Encapsulation Format to HLS or MP4)

    Fragment Length

    The duration of each TS segment. We recommend that you use the recommended value.

    Video Encryption

    You can enable this feature to encrypt HLS videos. After you enable video encryption, you must integrate an official player SDK that supports video decryption to play videos. A free trial is provided for this feature.

    Note

    The encryption feature configured here encrypts videos by using Alibaba Cloud proprietary cryptography. For more information about how to encrypt videos in standard HLS encryption mode, see HLS encryption

    5

    Conditional Transcoding Parameters

    Video Resolution Check

    Checks whether the resolution of the input video is lower than the resolution that is specified in the transcoding template.

    Video Bit Rate Check

    Checks whether the bitrate of the input video is lower than the video bitrate that is specified in the transcoding template.

    Audio Bit Rate Check

    Checks whether the bitrate of the input audio is lower than the audio bitrate that is specified in the transcoding template.

  6. Click Save.

  7. Optional. On the Transcoding Template Groups page, find the created transcoding template group and click Set as Default in the Actions column to set it as the default transcoding template group.

    After you specify a default template group, newly uploaded videos are transcoded based on this transcoding template group.

Audio transcoding

  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Configuration Management > Media Processing > Transcoding Template Groups.

  3. In the top navigation bar, select the desired region from the drop-down list next to the Workbench button.

  4. On the Transcoding Template Groups page, click Create Transcoding Template Group.

  5. In the Regular Transcoding Template section, click Add Template. Set Transcoding Type to Audio Transcoding and configure the following parameters.

    • Encapsulation Format: Select AAC or MP3.

    • Definition: Select Standard Quality or High Quality.

    • Keep the default settings for other parameters or modify the configurations based on your business requirements. For more information about the parameters and recommended configurations, see Configure regular transcoding templates.

image

  1. Click Save.

Container format conversion

  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Configuration Management > Media Processing > Transcoding Template Groups.

  3. In the top navigation bar, select the desired region from the drop-down list next to the Workbench button.

  4. On the Transcoding Template Groups page, click Create Transcoding Template Group.

  5. In the Regular Transcoding Template section, click Add Template. Set Transcoding Type to Container Format Conversion and configure the following parameters.

    • Encapsulation Format: Select HLS, MP4, FLV, or DASH.

    • Definition: Keep the original quality settings.

    • Keep the default settings for other parameters or modify the configurations based on your business requirements. For more information about the parameters and recommended configurations, see Configure regular transcoding templates.

image

  1. Click Save.

Narrowband HD™ 1.0 transcoding

Note

You can use Narrowband HDTM 1.0 transcoding to export videos only in the HLS or MP4 format.

  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Configuration Management > Media Processing > Transcoding Template Groups.

  3. In the top navigation bar, select the desired region from the drop-down list next to the Workbench button.

  4. On the Transcoding Template Groups page, click Create Transcoding Template Group.

  5. In the Regular Transcoding Template section, click Add Template. Set Transcoding Type to Narrowband HDTM 1.0 and configure the following parameters.

    • Encapsulation Format: Select HLS or MP4.

    • Scenario Type: Select Mini Dramas or Common Scenarios.

    • Definition: Select definitions related to Narrowband HD™ 1.0.

    • Keep the default settings for other parameters or modify the configurations based on your business requirements. For more information about the parameters and recommended configurations, see Configure regular transcoding templates.转码模板-窄1

  6. Click Save.

ABR streaming

  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Configuration Management > Media Processing > Transcoding Template Groups.

  3. In the top navigation bar, select the desired region from the drop-down list next to the Workbench button.

  4. On the Transcoding Template Groups page, click Create Transcoding Template Group.

  5. In the Video Packaging Template section, click Add Template and configure the following parameters.

    • Encapsulation Format: select HLS.

    • Definition: Select a desired definition for regular transcoding, audio transcoding, container format conversion, or Narrowband HD™ 1.0 transcoding.

    • Bandwidth Threshold: Specify a bandwidth threshold. The player can determine which bitstream to play by comparing the actual network bandwidth with the bandwidth threshold. Unit: bit/s. We recommend that you use the recommended value.

    • Keep the default settings for other parameters or modify the configurations based on your business requirements. For more information about the parameters and recommended configurations, see Configure regular transcoding templates.

  6. Click Save.

Use the ApsaraVideo VOD API

Call the AddTranscodeTemplateGroup operation to create different types of transcoding template groups.

  • Call the TranscodeTemplate operation and use the Type parameter to specify the type of the transcoding template group, such as regular transcoding or video packaging.

  • Call the TranscodeTemplate operation and use the Definition parameter to specify the definition of transcoded videos. You can specify a definition for regular transcoding, audio transcoding, container format conversion, or Narrowband HD™ 1.0 transcoding.

Manage transcoding template groups

After you create a transcoding template group, you can view, edit, or delete the transcoding template group, or specify the transcoding template group as the default transcoding template group. You cannot view, modify, or delete the No Transcoding template group.

Note

The changes to transcoding settings apply only to newly uploaded videos.

Use transcoding template groups

You can trigger transcoding jobs when you upload and process media files. You can specify a transcoding template group when you create a transcoding job. Alternatively, you can add a transcoding template group to a workflow and use the workflow to transcode media files. For more information, see the following topics: