All Products
Search
Document Center

ApsaraVideo Media Processing:AddTemplate

Last Updated:Jun 11, 2026

Membuat template transkoding kustom. Anda perlu mengonfigurasi informasi seperti format kontainer, pengaturan aliran video, dan pengaturan aliran audio.

Deskripsi operasi

When you call this operation, you need to set transcoding parameters such as those related to the container format, video stream, and audio stream. If you do not specify some parameters, streams that are generated by using the template do not contain the information specified by those parameters.

QPS limit

You can call this operation up to 100 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:AddTemplate

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama template transkoding. Nama dapat memiliki panjang hingga 128 byte.

mps-example

Container

string

No

Format kontainer. Nilai harus berupa objek JSON yang berisi parameter Format. Jika Anda tidak menentukan parameter ini, file media hasil Transkoding akan menggunakan format MP4 secara default. Parameter ini wajib diisi jika Anda ingin menggunakan template transkoding untuk menghasilkan file media dalam format lain. Untuk informasi selengkapnya, lihat Container.

  • Nilai default: MP4.

  • Transkoding video mendukung format berikut: FLV, MP4, HLS (M3U8 + TS), dan MPEG-DASH (MPD + fMP4).

Catatan

Jika format kontainer adalah FLV, Kodek video tidak dapat diatur ke H.265.

  • Transkoding audio mendukung format berikut: MP3, MP4, OGG, FLAC, dan M4A.

  • Transkoding gambar mendukung format GIF dan WebP.

Catatan
  • Jika format kontainer adalah GIF, Kodek video harus diatur ke GIF.

  • Jika format kontainer adalah WebP, Kodek video harus diatur ke WebP.

{"Format":"mp4"}

Video

string

No

Pengaturan aliran video. Nilai harus berupa objek JSON. Untuk informasi selengkapnya, lihat Video.

Catatan

Jika Anda tidak menentukan parameter ini, file keluaran tidak akan berisi aliran video. Parameter ini wajib diisi jika Anda ingin mempertahankan aliran video.

{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}

Audio

string

No

Pengaturan aliran audio. Nilai harus berupa objek JSON. Untuk informasi selengkapnya, lihat Audio.

Catatan

Jika Anda tidak menentukan parameter ini, file keluaran tidak akan berisi aliran audio. Parameter ini wajib diisi jika Anda ingin mempertahankan aliran audio.

{"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}

TransConfig

string

No

Pengaturan Transkoding umum. Nilai harus berupa objek JSON. Untuk informasi selengkapnya, lihat TransConfig. Jika Anda tidak menentukan parameter ini, pengaturan default akan digunakan. Parameter ini wajib diisi jika pengaturan default tidak dapat memenuhi kebutuhan bisnis Anda.

{"TransMode":"onepass"}

MuxConfig

string

No

Pengaturan segmen. Nilai harus berupa objek JSON. Untuk informasi selengkapnya, lihat MuxConfig. Jika Anda tidak menentukan parameter ini, file segmen media tidak akan dihasilkan. Parameter ini wajib diisi jika Anda ingin menghasilkan file segmen media.

{"Segment":{"Duration":"10"}}

Container.

ParameterTipeWajibDeskripsi
FormatStringTidakNilai default parameter ini adalah MP4. Transkoding video mendukung format berikut: FLV, MP4, HLS (M3U8 + TS), dan MPEG-DASH (MPD + fMP4). Transkoding audio mendukung format berikut: MP3, MP4, OGG, FLAC, dan M4A. Transkoding gambar mendukung format GIF dan WebP. Jika Anda mengatur format kontainer ke GIF, Kodek video harus diatur ke GIF. Jika Anda mengatur format kontainer ke WebP, Kodek video harus diatur ke WebP. Jika Anda mengatur format kontainer ke FLV, Kodek video tidak dapat diatur ke H.265.

Video

ParameterTipeWajibDeskripsi
CodecStringTidakKodek video. Nilai valid: H.264, H.265, GIF, dan WebP. Nilai default: H.264.
ProfileStringTidakProfil codec. Nilai valid: garis dasar, main, dan high. Nilai default: high. Nilai garis dasar menentukan bahwa file media ditranskoding untuk perangkat seluler. Nilai main menentukan bahwa file media ditranskoding untuk perangkat dengan resolusi Jenis Penyimpanan Standar. Nilai high menentukan bahwa file media ditranskoding untuk perangkat dengan resolusi tinggi. Jika tersedia beberapa definisi, atur parameter ini ke garis dasar untuk definisi terendah guna memastikan pemutaran normal pada perangkat kelas bawah. Atur parameter ini ke main atau high untuk definisi lainnya. Parameter ini hanya valid jika parameter Codec diatur ke H.264.
BitrateStringTidakNilai valid: 10 hingga 50000. Unit: Kbit/s.
CrfStringTidakFaktor laju konstan. Nilai valid: 0 hingga 51. Nilai default: 26. Jika Anda menentukan parameter ini, pengaturan parameter Bitrate menjadi tidak valid.
WidthStringTidakLebar video. Nilai valid: 128 hingga 4096. Nilai default: lebar video masukan. Unit: piksel.
HeightStringTidakTinggi video. Nilai valid: 128 hingga 4096. Nilai default: tinggi video masukan. Unit: piksel.
FpsStringTidakLaju frame video. Nilai default: laju frame file masukan. Nilai adalah 60 jika laju frame file masukan melebihi 60. Nilai valid: 0 hingga 60. Unit: frame per detik.
GopStringTidakUkuran kelompok gambar (GOP). Ukuran GOP dapat berupa interval maksimum keyframe atau jumlah maksimum frame dalam kelompok frame. Jika Anda menentukan interval maksimum keyframe, unit (s) wajib diisi. Nilai default: 10s. Jika Anda menentukan jumlah maksimum frame, nilai tidak memiliki unit. Nilai valid: 1 hingga 100000.
PresetStringTidakAlgoritma video preset. Nilai valid: veryfast, fast, Menengah, slow, dan slower. Nilai default: Menengah. Parameter ini hanya valid jika parameter Codec diatur ke H.264.
ScanModeStringTidakMode pemindaian. Nilai valid: interlaced dan progressive.
BufsizeStringTidakUkuran buffer. Nilai valid: 1000 hingga 128000. Nilai default: 6000. Unit: KB.
MaxrateStringTidakBitrate maksimum video. Nilai valid: 10 hingga 50000. Unit: Kbit/s.
PixFmtStringTidakFormat piksel video. Format piksel standar seperti yuv420p dan yuvj420p didukung. Secara default, yuv420p atau format piksel video masukan digunakan.
RemoveStringTidakApakah akan menghapus aliran video. Nilai true menentukan untuk menghapus aliran video. Nilai false menentukan untuk mempertahankan aliran video. Nilai default: false.
CropStringTidakMetode untuk memotong video. Nilai border menentukan untuk mendeteksi dan memotong batas hitam secara otomatis. Nilai dalam format width:height:left:top menentukan untuk memotong gambar video berdasarkan pengaturan kustom. Contoh: 1280:800:0:140.
PadStringTidakBatas hitam yang akan ditambahkan ke video. Nilai harus dalam format width:height:left:top. Contoh: 1280:800:0:140.
LongShortModeStringTidakApakah akan mengaktifkan fitur putar layar otomatis. Jika fitur ini diaktifkan, lebar video keluaran sesuai dengan sisi panjang video masukan, yang merupakan tinggi video masukan dalam mode potret. Tinggi video keluaran sesuai dengan sisi pendek video masukan, yang merupakan lebar video masukan dalam mode potret. Nilai true menentukan untuk mengaktifkan fitur putar layar otomatis. Nilai false menentukan untuk menonaktifkan fitur putar layar otomatis. Nilai default: false.

Tabel berikut menjelaskan kombinasi format kontainer, Kodek video, dan Kodek audio yang didukung.

Format kontainerKodek audioKodek video
FLVAAC dan MP3H.264
MP4AAC dan MP3H.264 dan H.265
TSAAC dan MP3H.264 dan H.265
M3U8AAC dan MP3H.264 dan H.265
GIFTidak didukungGIF

Tabel berikut menjelaskan parameter aliran video yang didukung oleh berbagai Kodek video. Nilai Y menentukan bahwa parameter didukung. Nilai N menentukan bahwa parameter tidak didukung.

Kodek videoH.264H.265GIF
ProfileYNN
BitrateYYN
CrfYYN
WidthYYY
HeightYYY
FpsYYY
GopYYN
PresetYNN
ScanModeYYY
BufsizeYYN
MaxrateYYN
PixFmtYYbgr8

Audio.

ParameterTipeWajibDeskripsi
CodecStringTidakKodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.
ProfileStringTidakProfil codec audio. Nilai valid jika parameter Codec diatur ke AAC: aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.
SamplerateStringTidakLaju pengambilan sampel. Nilai valid: 22050, 32000, 44100, 48000, dan 96000. Nilai default: 44100. Unit: Hz. Jika format kontainer video adalah FLV dan Kodek audio adalah MP3, laju pengambilan sampel tidak dapat berupa 32000, 48000, atau 96000. Jika Kodek audio adalah MP3, laju pengambilan sampel tidak dapat berupa 96000.
BitrateStringTidakBitrate audio file keluaran. Nilai valid: 8 hingga 1000. Nilai default: 128. Unit: Kbit/s.
ChannelsStringTidakJumlah saluran suara. Nilai default: 2. Nilai valid jika parameter Codec diatur ke MP3: 1 dan 2. Nilai valid jika parameter Codec diatur ke AAC: 1, 2, 4, 5, 6, dan 8.
RemoveStringTidakApakah akan menghapus aliran audio. Nilai true menentukan untuk menghapus aliran audio. Nilai false menentukan untuk mempertahankan aliran audio. Nilai default: false.

Tabel berikut menjelaskan kombinasi Kodek audio dan format kontainer yang didukung.

Format kontainerKodek audio
MP3MP3
MP4AAC
OGGVORBIS dan FLAC
FLACFLAC

TransConfig.

ParameterTipeWajibDeskripsi
TransModeStringTidakMode Transkoding. Nilai valid: onepass, twopass, dan CBR. Nilai default: onepass.
AdjDarMethodStringTidakMetode penyesuaian resolusi. Nilai valid: rescale, crop, pad, dan none. Nilai default: none.
IsCheckResoStringTidakApakah akan memeriksa resolusi. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file keluaran lebih tinggi daripada file masukan berdasarkan lebar atau tinggi, resolusi file masukan akan dipertahankan setelah Transkoding. Nilai true menentukan untuk memeriksa resolusi. Nilai false menentukan untuk tidak memeriksa resolusi. Nilai default: false.
IsCheckResoFailStringTidakApakah akan memeriksa resolusi. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file keluaran lebih tinggi daripada file masukan berdasarkan lebar atau tinggi, error yang menunjukkan kegagalan Transkoding akan dikembalikan. Nilai true menentukan untuk memeriksa resolusi. Nilai false menentukan untuk tidak memeriksa resolusi. Nilai default: false.
IsCheckVideoBitrateStringTidakApakah akan memeriksa bitrate video. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video file keluaran lebih besar daripada file masukan, bitrate video file masukan akan dipertahankan setelah Transkoding. Nilai true menentukan untuk memeriksa bitrate video. Nilai false menentukan untuk tidak memeriksa bitrate video. Nilai default: false.
IsCheckAudioBitrateStringTidakApakah akan memeriksa bitrate audio. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio file keluaran lebih besar daripada file masukan, bitrate audio file masukan akan dipertahankan setelah Transkoding. Nilai true menentukan untuk memeriksa bitrate audio. Nilai false menentukan untuk tidak memeriksa bitrate audio. Nilai default: false.
IsCheckAudioBitrateFailStringTidakApakah akan memeriksa bitrate audio. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio keluaran lebih tinggi daripada audio masukan, audio masukan tidak akan ditranskoding. Nilai true menentukan untuk memeriksa bitrate audio. Nilai false menentukan untuk tidak memeriksa bitrate audio. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckAudioBitrate.
IsCheckVideoBitrateFailStringTidakApakah akan memeriksa bitrate video. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video keluaran lebih tinggi daripada video masukan, video masukan tidak akan ditranskoding. Nilai true menentukan untuk memeriksa bitrate video. Nilai false menentukan untuk tidak memeriksa bitrate video. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckVideoBitrate.

MuxConfig.

ParameterTipeWajibDeskripsi
SegmentStringTidakPengaturan segmen. Nilai harus berupa objek JSON. Untuk informasi selengkapnya, lihat bagian berikut.

Segment.

ParameterTipeWajibDeskripsi
DurationStringTidakPanjang segmen. Nilai harus berupa bilangan bulat. Unit: detik. Nilai valid: 1 hingga 60. Nilai default: 10.
ForceSegTimeStringTidakTitik waktu saat Anda ingin membagi file media menjadi segmen. Anda dapat menentukan hingga 10 titik waktu. Pisahkan titik waktu dengan koma (,). Titik waktu dapat akurat hingga tiga tempat desimal. Unit: detik. Misalnya, jika Anda mengatur parameter ini ke 23,55,60, file media akan dibagi menjadi segmen pada detik ke-23, ke-55, dan ke-60.

Elemen respons

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The ID of the request.

FA258E67-09B8-4EAA-8F33-BA567834A2C3

Template

object

The details of the transcoding template.

Video

object

The video codec configurations.

Bufsize

string

The size of the buffer.

  • Default value: 6000.

  • Unit: KB.

6000

LongShortMode

string

Indicates whether the auto-rotate screen feature is enabled. Default value: false. Valid values:

  • true: The auto-rotate screen feature is enabled.

  • false: The auto-rotate screen feature is disabled.

Catatan

If this feature is enabled, the width of the output video corresponds to the long side of the input video, which is the height of the input video in portrait mode. The height of the output video corresponds to the short side of the input video, which is the width of the input video in portrait mode.

false

Degrain

string

The level of quality control on the video.

10

BitrateBnd

object

The bitrate range of the video.

Max

string

The maximum bitrate.

1500

Min

string

The minimum bitrate.

800

PixFmt

string

The pixel format. Standard pixel formats such as yuv420p and yuvj420p are supported. The default pixel format can be yuv420p or the pixel format of the input video.

yuv420p

Pad

string

The black borders to be added to the video. The value is in the width:height:left:top format.

1280:800:0:140

Codec

string

The video codec. Valid values: H.264, H.265, GIF, and WebP. Default value: H.264.

H.264

Height

string

The height of the video.

  • Unit: pixel.

  • Default value: the height of the input video.

800

Qscale

string

The level of the independent denoising algorithm.

1

Crop

string

The method of video cropping. Valid values:

  • border: automatically detects and removes borders.

  • Value in the format of width:height:left:top: crops the video image based on the custom settings. Example: 1280:800:0:140.

border

Bitrate

string

The bitrate of the output video. Unit: Kbit/s.

500

Maxrate

string

The maximum bitrate of the video. Unit: Kbit/s.

500

MaxFps

string

The maximum frame rate.

60

Profile

string

The codec profile.

  • baseline: suitable for mobile devices

  • main: suitable for standard-definition devices

  • high: suitable for high-definition devices

  • Default value: high.

If multiple definitions are available, we recommend that you set this parameter to baseline for the lowest definition to ensure normal playback on low-end devices. Set this parameter to main or high for other definitions.

Catatan

This parameter is valid only if the Codec parameter is set to H.264.

high

Crf

string

The constant rate factor. Default value if the video codec is set to H.264: 23. Default value if the video codec is set to H.265: 26.

Catatan

If this parameter is specified, the setting of the Bitrate parameter becomes invalid.

15

Remove

string

Indicates whether the video stream is deleted.

  • true: The video stream is deleted.

  • false: The video stream is retained.

  • Default value: false.

false

Gop

string

The GOP size. The GOP size can be the maximum interval of keyframes or the maximum number of frames in a frame group. If the maximum interval is specified, the value contains the unit (s). If the maximum number of frames is specified, the value does not contain a unit. Default value: 10s.

10s

Width

string

The width of the video.

  • Default value: the width of the input video.****

  • Unit: pixel.

256

Fps

string

The frame rate. Default value: the frame rate of the input file. The value is 60 if the frame rate of the input file exceeds 60. Unit: frames per second.

25

Preset

string

The preset video algorithm. Default value: medium. Valid values:

  • veryfast

  • fast

  • medium

  • slow

  • slower

Catatan

This parameter is valid only if the Codec parameter is set to H.264.

fast

ScanMode

string

The scan mode. Valid values:

  • interlaced

  • progressive

interlaced

ResoPriority

string

The policy of resolution adjustment.

0

Hdr2sdr

string

Indicates whether the HDR2SDR conversion feature is enabled. If this feature is enabled, high dynamic range (HDR) videos are transcoded to standard dynamic range (SDR) videos.

true

NarrowBand

object

The Narrowband HD settings.

Version

string

The Narrowband HD version. Only 1.0 may be returned.

1.0

Abrmax

number

The upper limit of the dynamic bitrate. If this parameter is set, the average bitrate is in the range of (0, 1000000].

3000

MaxAbrRatio

number

The maximum ratio of the upper limit of dynamic bitrate. If this parameter is set, the value of Abrmax does not exceed x times of the source video bitrate. Valid values: (0,1.0].

1.0

TransConfig

object

The general transcoding settings.

IsCheckAudioBitrate

string

Indicates whether the audio bitrate is checked.

If this feature is enabled and the system detects that the audio bitrate of the output file is greater than that of the input file, the audio bitrate of the input file is retained after transcoding.

  • true: The audio bitrate is checked.

  • false: The audio bitrate is not checked.

  • Default value: false.

true

TransMode

string

The transcoding mode. Valid values:

  • onepass

  • twopass

  • CBR

  • Default value: onepass.

onepass

IsCheckReso

string

Indicates whether the resolution is checked.

  • true: The resolution is checked.

  • false: The resolution is not checked.

  • Default value: false.

Catatan

If this feature is enabled and the system detects that the resolution of the output file is higher than that of the input file based on the width or height, the resolution of the input file is retained after transcoding.

true

IsCheckVideoBitrateFail

string

Indicates whether the video bitrate is checked. If this feature is enabled and the system detects that the video bitrate of the output file is higher than that of the input file, the input file is not transcoded. This parameter has a higher priority than the IsCheckVideoBitrate parameter.

  • true: The video bitrate is checked. In this case, if the video bitrate of the output file is higher than that of the input file, the input file is not transcoded.

  • false: The video bitrate is not checked.

  • Default value: false.

true

AdjDarMethod

string

The method of resolution adjustment. Default value: none. Valid values:

  • rescale: The input video is rescaled.

  • crop: The input video is cropped.

  • none: No change is made.

rescale

IsCheckVideoBitrate

string

Indicates whether the video bitrate is checked.

  • true: The video bitrate is checked.

  • false: The video bitrate is not checked.

  • Default value: false.

Catatan

If this feature is enabled and the system detects that the video bitrate of the output file is greater than that of the input file, the video bitrate of the input file is retained after transcoding.

true

IsCheckResoFail

string

Indicates whether the resolution is checked.

  • true: The resolution is checked.

  • false: The resolution is not checked.

  • Default value: false.

Catatan

If this feature is enabled and the system detects that the resolution of the output file is higher than that of the input file based on the width or height, an error that indicates a transcoding failure is returned.

true

IsCheckAudioBitrateFail

string

Indicates whether the audio bitrate is checked. If this feature is enabled and the system detects that the audio bitrate of the output file is higher than that of the input file, the input file is not transcoded. This parameter has a higher priority than the IsCheckAudioBitrate parameter. Valid values:

  • true: The audio bitrate is checked. In this case, if the audio bitrate of the output file is higher than that of the input file, the input file is not transcoded.

  • false: The audio bitrate is not checked.

  • Default value: false.

true

State

string

The status of the template. Valid values:

  • Normal: The template is normal.

  • Deleted: The template is deleted.

Normal

MuxConfig

object

The transmuxing settings.

Webp

object

The transmuxing settings for WebP.

Loop

string

The loop count.

0

Gif

object

The transmuxing settings for GIF.

FinalDelay

string

The duration for which the final frame is paused. Unit: centiseconds.

0

DitherMode

string

The color dithering algorithm of the palette. Valid values: sierra and bayer.

sierra

Loop

string

The loop count.

0

IsCustomPalette

string

Indicates whether the custom palette is used.

false

Segment

object

The segment settings.

Duration

string

The length of the segment. Unit: seconds.

10

Name

string

The name of the transcoding template.

mps-example

Audio

object

The audio codec configurations.

Profile

string

The codec profile of the audio. Valid values if the Codec parameter is set to AAC:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

  • aac_eld

aac_low

Remove

string

Indicates whether the audio stream is deleted.

  • true: The audio stream is deleted.

  • false: The audio stream is retained.

  • Default value: false.

true

Codec

string

The audio codec format. Default value: aac. Valid values:

  • aac

  • mp3

  • vorbis

  • flac

aac

Samplerate

string

The sampling rate.

  • Unit: Hz.

  • Default value: 44100.

44100

Qscale

string

The level of the independent denoising algorithm.

5

Channels

string

The number of sound channels. Default value: 2.

2

Volume

object

The volume control configurations

Method

string

The volume adjustment method. Valid values:

  • auto: The volume is automatically adjusted.

  • dynamic: The volume is dynamically adjusted.

  • linear: The volume is linearly adjusted.

auto

Level

string

The volume adjustment range.

  • Default value: -20.

  • Unit: dB.

-20

IntegratedLoudnessTarget

string

The output volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [-70,-5].

Default value: -6.

TruePeak

string

The peak volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [-9,0].

Default value: -1.

LoudnessRangeTarget

string

The range of the volume relative to the output volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [1,20].

Default value: 8.

PeakLevel

string

The volume adjustment coefficient.

This parameter takes effect only when the value of Method is adaptive.

Valid values: [0,1].

Default value: 0.9.

Bitrate

string

The audio bitrate of the output file.

  • Unit: Kbit/s.

  • Default value: 128.

500

Id

string

The ID of the transcoding template. We recommend that you keep this ID for subsequent operation calls.

16f01ad6175e4230ac42bb5182cd****

Container

object

The container format settings.

Format

string

The container format.

mp4

Contoh

Respons sukses

JSONformat

{
  "RequestId": "FA258E67-09B8-4EAA-8F33-BA567834A2C3",
  "Template": {
    "Video": {
      "Bufsize": "6000",
      "LongShortMode": "false",
      "Degrain": "10",
      "BitrateBnd": {
        "Max": "1500",
        "Min": "800"
      },
      "PixFmt": "yuv420p",
      "Pad": "1280:800:0:140",
      "Codec": "H.264",
      "Height": "800",
      "Qscale": "1",
      "Crop": "border",
      "Bitrate": "500",
      "Maxrate": "500",
      "MaxFps": "60",
      "Profile": "high",
      "Crf": "15",
      "Remove": "false",
      "Gop": "10s",
      "Width": "256",
      "Fps": "25",
      "Preset": "fast",
      "ScanMode": "interlaced",
      "ResoPriority": "0",
      "Hdr2sdr": "true",
      "NarrowBand": {
        "Version": "1.0",
        "Abrmax": 3000,
        "MaxAbrRatio": 1
      }
    },
    "TransConfig": {
      "IsCheckAudioBitrate": "true",
      "TransMode": "onepass",
      "IsCheckReso": "true",
      "IsCheckVideoBitrateFail": "true",
      "AdjDarMethod": "rescale",
      "IsCheckVideoBitrate": "true",
      "IsCheckResoFail": "true",
      "IsCheckAudioBitrateFail": "true"
    },
    "State": "Normal",
    "MuxConfig": {
      "Webp": {
        "Loop": "0"
      },
      "Gif": {
        "FinalDelay": "0",
        "DitherMode": "sierra",
        "Loop": "0",
        "IsCustomPalette": "false"
      },
      "Segment": {
        "Duration": "10"
      }
    },
    "Name": "mps-example",
    "Audio": {
      "Profile": "aac_low",
      "Remove": "true",
      "Codec": "aac",
      "Samplerate": "44100",
      "Qscale": "5",
      "Channels": "2",
      "Volume": {
        "Method": "auto",
        "Level": "-20",
        "IntegratedLoudnessTarget": "-6",
        "TruePeak": "0",
        "LoudnessRangeTarget": "8",
        "PeakLevel": "0.9"
      },
      "Bitrate": "500"
    },
    "Id": "16f01ad6175e4230ac42bb5182cd****",
    "Container": {
      "Format": "mp4"
    }
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.