All Products
Search
Document Center

ApsaraVideo Media Processing:AddTemplate

Last Updated:Oct 12, 2026

Membuat templat kustom yang menyertakan informasi kontainer, pengaturan aliran video, dan pengaturan aliran audio.

Deskripsi operasi

Parameter permintaan untuk operasi ini mencakup informasi kontainer, pengaturan aliran video, dan pengaturan aliran audio. Jika Anda tidak mengonfigurasi bagian tertentu, informasi terkait tidak akan disertakan dalam aliran keluaran yang ditranskoding menggunakan templat.

Batas QPS

Batas QPS untuk satu pengguna adalah 100 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Lakukan panggilan API pada laju yang wajar. Untuk informasi selengkapnya, lihat Batas QPS.

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

*Semua resource.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama templat. Panjang maksimum adalah 128 byte.

mps-example

Container

string

No

Kontainer. Nilainya adalah objek JSON yang berisi parameter Format, yang menentukan format kontainer. Jika Anda tidak mengonfigurasi parameter Container, format keluaran default adalah MP4. Untuk menggunakan format lain, Anda harus mengonfigurasi parameter ini. Untuk informasi selengkapnya, lihat Detail kontainer.

  • Nilai default: MP4.

  • Transkoding video mendukung 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 MP3, MP4, OGG, FLAC, dan M4A.

  • Gambar mendukung GIF dan WebP.

Catatan

Jika format kontainer adalah GIF, Kodek video hanya dapat diatur ke GIF. Jika format kontainer adalah WebP, Kodek video hanya dapat diatur ke WebP.

{"Format":"mp4"}

Video

string

No

Konfigurasi aliran video. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat Detail video.

Catatan

Jika Anda tidak mengonfigurasi parameter Video, keluaran transkoding tidak akan menyertakan aliran video. Untuk mempertahankan aliran video, Anda harus mengonfigurasi parameter ini.

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

Audio

string

No

Konfigurasi aliran audio. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat Detail audio.

Catatan

Jika Anda tidak mengonfigurasi parameter Audio, keluaran transkoding tidak akan menyertakan aliran audio. Untuk mempertahankan aliran audio, Anda harus mengonfigurasi parameter ini.

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

TransConfig

string

No

Konfigurasi transkoding umum. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat Detail TransConfig. Jika Anda tidak mengonfigurasi parameter TransConfig, semua konfigurasi transkoding akan menggunakan nilai default. Jika nilai default tidak memenuhi persyaratan transkoding Anda, Anda harus mengonfigurasi parameter ini sesuai kebutuhan.

{"TransMode":"onepass"}

MuxConfig

string

No

Konfigurasi segmen. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat Detail MuxConfig. Jika Anda tidak mengonfigurasi parameter MuxConfig, keluaran transkoding tidak akan dibagi menjadi segmen. Untuk membagi keluaran menjadi segmen, Anda harus mengonfigurasi parameter ini.

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

Detail objek JSON Kontainer

ParameterTipeWajibDeskripsi
FormatStringTidakNilai default: mp4. Transkoding video mendukung flv, mp4, HLS (m3u8+ts), dan MPEG-DASH (MPD+fMP4). Transkoding audio mendukung mp3, mp4, ogg, flac, dan m4a. Gambar mendukung gif dan WEBP. Jika format kontainer adalah gif, parameter Video Codec harus diatur ke GIF. Jika format kontainer adalah webp, parameter Video Codec harus diatur ke WEBP. Jika format kontainer adalah flv, parameter Video Codec tidak dapat diatur ke H.265.

Detail objek JSON Video

ParameterTipeWajibDeskripsi
CodecStringTidakFormat Kodek. Nilai valid: H.264, H.265, GIF, dan WEBP. Nilai default: H.264.
ProfileStringTidakProfil pengkodean. Nilai valid: garis dasar (cocok untuk perangkat seluler), main (cocok untuk perangkat definisi standar), dan high (cocok untuk perangkat resolusi tinggi). Nilai default: high. Praktik Terbaik: Jika Anda memiliki beberapa resolusi, atur resolusi terendah ke garis dasar untuk memastikan pemutaran pada perangkat kelas bawah. Atur resolusi lainnya ke main atau high. Parameter ini hanya didukung oleh H.264.
BitrateStringTidakNilai valid: 10 hingga 50000. Unit: Kbps.
CrfStringTidakFaktor laju konstan (CRF) untuk kontrol bitrate dan kualitas. Nilai valid: 0 hingga 51. Nilai default: 26. Jika Crf diatur, Pengaturan Bitrate menjadi tidak valid.
WidthStringTidakLebar video. Nilai default: lebar video asli. Nilai valid: 128 hingga 4096. Unit: piksel.
HeightStringTidakTinggi video. Nilai default: tinggi video asli. Nilai valid: 128 hingga 4096. Unit: piksel.
FpsStringTidakLaju frame. Nilai default: laju frame file input. Jika laju frame file input melebihi 60, nilai 60 digunakan. Nilai valid: 0 hingga 60. Unit: FPS.
GopStringTidakInterval waktu maksimum atau jumlah frame maksimum antar keyframe. Saat menentukan interval waktu maksimum, unit harus dalam detik. Nilai default: 10s. Saat menentukan jumlah frame maksimum, tidak diperlukan unit. Nilai valid: 1 hingga 100000.
PresetStringTidakPreset algoritma video. Nilai valid: veryfast (sangat cepat), fast (cepat), medium (Menengah), slow (lambat), dan slower (sangat lambat). Nilai default: medium. Parameter ini hanya didukung oleh H.264.
ScanModeStringTidakPola pemindaian. Nilai valid: interlaced dan progressive.
BufsizeStringTidakUkuran buffer. Nilai valid: [1000, 128000]. Nilai default: 6000. Unit: KB.
MaxrateStringTidakBitrate puncak video. Nilai valid: [10, 50000]. Unit: Kbps.
PixFmtStringTidakFormat piksel video. Nilai valid mencakup format piksel standar seperti yuv420p dan yuvj420p. Nilai default: yuv420p atau format piksel asli.
RemoveStringTidakApakah akan menghapus aliran video. Nilai true menunjukkan bahwa aliran video dihapus. Nilai false menunjukkan bahwa aliran video dipertahankan. Nilai default: false.
CropStringTidakKonfigurasi pemotongan video. Dua metode didukung: deteksi dan pemotongan bilah hitam secara otomatis, di mana nilai diatur ke border. Pemotongan kustom menggunakan format parameter width:height:left:top. Contoh: 1280:800:0:140.
PadStringTidakKonfigurasi padding video. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.
LongShortModeStringTidakApakah akan mengaktifkan pola lanskap dan potret adaptif (pola sisi panjang dan pendek). Lebar output hasil transkoding sesuai dengan sisi panjang video input (tinggi untuk video potret), dan tinggi sesuai dengan sisi pendek video input (lebar untuk video potret). Nilai true menunjukkan bahwa fitur diaktifkan. Nilai false menunjukkan bahwa fitur dinonaktifkan. Nilai default: false.

Tabel berikut menunjukkan kombinasi yang didukung antara kodek transkoding video dan format kontainer:

KontainerKodek AudioKodek Video
flvAAC, MP3H.264
mp4AAC, MP3H.264, H.265
tsAAC, MP3H.264, H.265
m3u8AAC, MP3H.264, H.265
gifTidak didukungGIF

Tabel berikut menunjukkan kombinasi yang didukung antara kodek video dan parameter konfigurasi aliran video:

Video/KodekH.264H.265GIF
ProfileYNN
BitrateYYN
CrfYYN
WidthYYY
HeightYYY
FpsYYY
GopYYN
PresetYNN
ScanModeYYY
BufsizeYYN
MaxrateYYN
PixFmtYYbgr8

Detail objek JSON Audio

ParameterTipeDiperlukanDeskripsi
CodecStringTidakKodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.
ProfileStringTidakProfil pengkodean audio. Saat Codec diatur ke AAC, nilai valid adalah aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.
SamplerateStringTidakLaju pengambilan sampel. Nilai default: 44100. Nilai valid: 22050, 32000, 44100, 48000, dan 96000. Unit: Hz. Jika format kontainer video adalah flv dan kodek audio adalah mp3, laju pengambilan sampel 32000, 48000, dan 96000 tidak didukung. Jika kodek audio adalah mp3, laju pengambilan sampel 96000 tidak didukung.
BitrateStringTidakBitrate audio dari file keluaran. Nilai valid: 8 hingga 1000. Unit: Kbps. Nilai default: 128.
ChannelsStringTidakJumlah saluran audio. Nilai default: 2. Saat Codec diatur ke mp3, hanya 1 dan 2 yang didukung. Saat Codec diatur ke aac, hanya 1, 2, 4, 5, 6, dan 8 yang didukung.
RemoveStringTidakApakah akan menghapus aliran audio. Nilai true menunjukkan bahwa aliran audio dihapus. Nilai false menunjukkan bahwa aliran audio dipertahankan. Nilai default: false.

Tabel berikut menunjukkan kombinasi yang didukung antara kodek transkoding audio dan format kontainer:

KontainerKodek Audio
mp3MP3
mp4AAC
oggVORBIS, FLAC
flacFLAC

Detail objek JSON TransConfig

ParameterTipeDiperlukanDeskripsi
TransModeStringTidakMode transkoding. Nilai default: onepass. Nilai valid: onepass, twopass, dan CBR.
AdjDarMethodStringTidakMetode penyesuaian resolusi. Nilai default: none. Nilai valid: rescale, crop, pad, dan none.
IsCheckResoStringTidakApakah akan memeriksa resolusi. Jika resolusi keluaran audio lebih besar dari resolusi masukan dalam lebar atau tinggi, resolusi keluaran audio diatur ke resolusi masukan. Nilai true menunjukkan bahwa resolusi diperiksa. Nilai false menunjukkan bahwa resolusi tidak diperiksa. Nilai default: false.
IsCheckResoFailStringTidakApakah akan memeriksa resolusi. Jika resolusi keluaran audio lebih besar dari resolusi masukan dalam lebar atau tinggi, transkoding gagal. Nilai true menunjukkan bahwa resolusi diperiksa. Nilai false menunjukkan bahwa resolusi tidak diperiksa. Nilai default: false.
IsCheckVideoBitrateStringTidakApakah akan memeriksa bitrate video. Jika bitrate video keluaran audio lebih besar dari bitrate video masukan, bitrate video keluaran audio diatur ke bitrate video masukan. Nilai true menunjukkan bahwa bitrate video diperiksa. Nilai false menunjukkan bahwa bitrate video tidak diperiksa. Nilai default: false.
IsCheckAudioBitrateStringTidakApakah akan memeriksa bitrate audio. Jika bitrate audio keluaran audio lebih besar dari bitrate audio masukan, bitrate audio keluaran audio diatur ke bitrate audio masukan. Nilai true menunjukkan bahwa bitrate audio diperiksa. Nilai false menunjukkan bahwa bitrate audio tidak diperiksa. Nilai default: false.
IsCheckAudioBitrateFailStringTidakApakah akan menyebabkan transkoding gagal ketika bitrate audio keluaran audio lebih besar dari bitrate audio sumber. Nilai true menunjukkan bahwa transkoding tidak dilakukan. Nilai false menunjukkan bahwa tidak ada pemeriksaan yang dilakukan. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckAudioBitrate.
IsCheckVideoBitrateFailStringTidakApakah akan menyebabkan transkoding gagal ketika bitrate video keluaran audio lebih besar dari bitrate video sumber. Nilai true menunjukkan bahwa transkoding tidak dilakukan. Nilai false menunjukkan bahwa tidak ada pemeriksaan yang dilakukan. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckVideoBitrate.

Detail objek JSON MuxConfig

ParameterTipeDiperlukanDeskripsi
SegmentStringTidakKonfigurasi segmen. Nilai berupa objek JSON. Untuk informasi lebih lanjut, lihat Detail segmen.

Detail segmen

ParameterTipeDiperlukanDeskripsi
DurationStringTidakDurasi segmen. Nilai harus berupa bilangan bulat. Unit: detik. Nilai valid: 1 hingga 60. Nilai default: 10.
ForceSegTimeStringTidakDaftar pengatur waktu segmen yang ditentukan. Pisahkan beberapa nilai dengan koma (,). Anda dapat menentukan hingga 10 pengatur waktu segmen. Nilai harus berupa bilangan desimal dengan hingga tiga tempat desimal. Unit: detik. Contoh: 23, 55, 60, yang menunjukkan bahwa segmen dibuat pada detik ke-23, 55, dan 60.

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

RequestId

string

ID permintaan.

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

Template

object

Detail template transkoding.

Video

object

Konfigurasi Kodek video.

Bufsize

string

Ukuran buffer.

  • Nilai default: 6000.

  • Unit: KB.

6000

LongShortMode

string

Apakah akan mengaktifkan mode lanskap dan potret adaptif (mode sisi panjang dan pendek). Nilai default: false. Nilai valid:

  • true: Mengaktifkan mode lanskap dan potret adaptif.

  • false: Menonaktifkan mode lanskap dan potret adaptif.

Catatan

Lebar output hasil transkoding sesuai dengan sisi panjang video input (tinggi untuk video potret), dan tinggi sesuai dengan sisi pendek video input (lebar untuk video potret).

false

Degrain

string

Tingkat kontrol kualitas video.

10

BitrateBnd

object

Rentang bitrate video.

Max

string

Bitrate maksimum.

1500

Min

string

Bitrate minimum.

800

PixFmt

string

Format piksel video. Nilai valid mencakup format piksel standar seperti yuv420p dan yuvj420p. Nilai default: yuv420p atau format piksel asli.

yuv420p

Pad

string

Konfigurasi padding video. Format parameter: width:height:left:top.

1280:800:0:140

Codec

string

Format Kodek. Nilai valid: H.264, H.265, GIF, dan WEBP. Nilai default: H.264.

H.264

Height

string

Tinggi video.

  • Unit: piksel.

  • Nilai default: tinggi video asli.

800

Qscale

string

Kekuatan algoritma penghilangan derau independen.

1

Crop

string

Konfigurasi pemotongan video. Dua metode didukung:

  • Deteksi dan pemotongan bilah hitam secara otomatis: Atur nilai menjadi border.

  • Pemotongan kustom: Tentukan parameter kustom untuk pemotongan. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.

border

Bitrate

string

Bitrate file keluaran. Unit: Kbps.

500

Maxrate

string

Bitrate puncak video. Unit: Kbps.

500

MaxFps

string

Laju frame maksimum.

60

Profile

string

Profil pengkodean.

  • garis dasar: cocok untuk perangkat seluler.

  • main: cocok untuk perangkat definisi standar.

  • high: cocok untuk perangkat resolusi tinggi.

  • Nilai default: high.

Praktik Terbaik: Jika Anda memiliki beberapa resolusi, atur resolusi terendah ke garis dasar untuk memastikan pemutaran pada perangkat kelas bawah. Atur resolusi lainnya ke main atau high.

Catatan

Parameter ini hanya didukung oleh H.264.

high

Crf

string

Faktor laju konstan (CRF) untuk kontrol bitrate dan kualitas. Nilai default: Ketika format encoding adalah H.264, nilai default adalah 23. Ketika format encoding adalah H.265, nilai default adalah 26.

Catatan

Jika Crf diatur, Pengaturan Bitrate menjadi tidak valid.

15

Remove

string

Apakah akan menghapus aliran video.

  • true: Menghapus aliran video.

  • false: Mempertahankan aliran video.

  • Nilai default: false.

false

Gop

string

Pengatur waktu maksimum atau jumlah frame maksimum antar keyframe. Saat menentukan pengatur waktu maksimum, unit harus dalam detik. Saat menentukan jumlah frame maksimum, tidak diperlukan unit. Nilai default: 10s.

10s

Width

string

Lebar video.

  • Nilai default: lebar video asli.

  • Unit: piksel.

256

Fps

string

Laju frame. Nilai default: laju frame file input. Jika laju frame file input melebihi 60, nilai 60 digunakan. Unit: FPS.

25

Preset

string

Preset algoritma video. Nilai default: medium. Nilai valid:

  • veryfast: sangat cepat

  • fast: cepat

  • medium: Menengah

  • slow: lambat

  • slower: sangat lambat

Catatan

Parameter ini hanya didukung oleh H.264.

fast

ScanMode

string

Mode pemindaian. Nilai valid:

  • interlaced: pemindaian interlaced

  • progressive: pemindaian progresif

interlaced

ResoPriority

string

Prioritas penyesuaian resolusi.

0

Hdr2sdr

string

Apakah akan mengaktifkan fitur konversi HDR ke SDR. Saat diaktifkan, video HDR dikonversi ke SDR.

true

NarrowBand

object

Parameter konfigurasi Narrowband HD.

Version

string

Versi Narrowband HD. Nilai valid: 1.0.

1.0

Abrmax

number

Batas atas bitrate dinamis. Setelah parameter ini diatur, bitrate rata-rata berada dalam rentang (0, 1000000].

3000

MaxAbrRatio

number

Pengali maksimum untuk batas atas bitrate. Setelah parameter ini diatur, abrmax tidak melebihi x kali bitrate video sumber. Nilai valid: (0, 1.0].

1.0

TransConfig

object

Konfigurasi transkoding umum.

IsCheckAudioBitrate

string

Apakah akan memeriksa bitrate audio. Jika bitrate audio output lebih besar dari bitrate audio sumber, bitrate audio output dianggap sama dengan bitrate audio sumber, dan parameter bitrate audio yang ditentukan tidak berlaku. Prioritas parameter ini lebih rendah daripada IsCheckAudioBitrateFail.

  • true: Memeriksa bitrate audio.

  • false: Tidak memeriksa bitrate audio.

  • Nilai default:
    • false jika parameter kosong dan Kodek berbeda dari sumber input.

    • true jika parameter kosong dan Kodek sama dengan sumber input.

true

TransMode

string

Mode transkoding. Nilai valid:

  • onepass

  • twopass

  • CBR

  • Nilai default: onepass

onepass

IsCheckReso

string

Apakah akan memeriksa resolusi. Jika resolusi output lebih besar dari resolusi input dalam lebar atau tinggi, resolusi output diatur ke resolusi input.

  • true: Memeriksa resolusi.

  • false: Tidak memeriksa resolusi.

  • Nilai default: false.

true

IsCheckVideoBitrateFail

string

Apakah akan memeriksa bitrate video. Jika bitrate video output lebih besar dari bitrate video sumber, prioritas parameter ini lebih tinggi daripada IsCheckVideoBitrate.

  • true: Melewati transkoding.

  • false: Tidak memeriksa bitrate video.

  • Nilai default: false.

true

AdjDarMethod

string

Metode penyesuaian resolusi. Nilai default: none. Nilai valid:

  • rescale: meregangkan video agar sesuai dengan resolusi.

  • crop: memotong video secara bertahap.

  • none: tidak membuat perubahan.

rescale

IsCheckVideoBitrate

string

Apakah akan memeriksa bitrate video. Jika bitrate video output lebih besar dari bitrate video input, bitrate video output diatur ke bitrate video input.

  • true: Memeriksa bitrate video.

  • false: Tidak memeriksa bitrate video.

  • Nilai default: false.

true

IsCheckResoFail

string

Apakah akan memeriksa resolusi. Jika resolusi output lebih besar dari resolusi input dalam lebar atau tinggi, kegagalan transkoding dikembalikan.

  • true: Memeriksa resolusi.

  • false: Tidak memeriksa resolusi.

  • Nilai default: false.

true

IsCheckAudioBitrateFail

string

Apakah akan memeriksa bitrate audio. Jika bitrate audio output lebih besar dari bitrate audio sumber, prioritas parameter ini lebih tinggi daripada IsCheckAudioBitrate.

  • true: Melewati transkoding.

  • false: Tidak memeriksa bitrate audio.

  • Nilai default: false.

true

State

string

Status template.

  • Normal: Template normal.

  • Deleted: Template dihapus.

Normal

MuxConfig

object

Konfigurasi muxing transkoding.

Webp

object

Konfigurasi muxing untuk WebP.

Loop

string

Jumlah loop.

0

Gif

object

Konfigurasi muxing untuk GIF.

FinalDelay

string

Durasi jeda frame terakhir. Unit: centidetik.

0

DitherMode

string

Metode dithering warna untuk palet. Nilai valid: sierra dan bayer.

sierra

Loop

string

Jumlah loop.

0

IsCustomPalette

string

Apakah akan menggunakan palet kustom.

false

Segment

object

Konfigurasi segmen.

Duration

string

Durasi segmen. Unit: detik.

10

Name

string

Nama template.

mps-example

Audio

object

Konfigurasi Kodek audio.

Profile

string

Profil pengkodean audio. Saat Codec diatur ke aac, nilai valid adalah:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

  • aac_eld

aac_low

Remove

string

Apakah akan menghapus aliran audio.

  • true: Menghapus aliran audio.

  • false: Mempertahankan aliran audio.

  • Nilai default: false.

true

Codec

string

Format Kodek audio. Nilai default: aac. Nilai valid:

  • aac

  • mp3

  • vorbis

  • flac

aac

Samplerate

string

Laju pengambilan sampel.

  • Unit: Hz.

  • Nilai default: 44100.

44100

Qscale

string

Kekuatan algoritma penghilangan derau independen.

5

Channels

string

Jumlah saluran audio. Nilai default: 2.

2

Volume

object

Detail volume.

Method

string

Metode penyesuaian volume. Nilai valid:

  • auto: penyesuaian otomatis

  • dynamic: penyesuaian dinamis

  • linear: penyesuaian linear

auto

Level

string

Tingkat penyesuaian volume.

  • Nilai default: -20.

  • Unit: dB.

-20

IntegratedLoudnessTarget

string

Volume target. Parameter ini hanya berlaku saat Method diatur ke dynamic. Unit: dB. Nilai valid: [-70, -5]. Nilai default: -6.

-6

TruePeak

string

Volume Puncak. Parameter ini hanya berlaku saat Method diatur ke dynamic. Unit: dB. Nilai valid: [-9, 0]. Nilai default: -1.

-1

LoudnessRangeTarget

string

Rentang fluktuasi relatif terhadap volume target. Parameter ini hanya berlaku saat Method diatur ke dynamic. Unit: dB. Nilai valid: [1, 20]. Nilai default: 8.

8

PeakLevel

string

Koefisien penyesuaian volume. Parameter ini hanya berlaku saat Method diatur ke adaptive. Nilai valid: [0, 1]. Nilai default: 0.9.

0.9

Bitrate

string

Bitrate audio file output.

  • Unit: Kbps.

  • Nilai default: 128.

500

Id

string

ID template transkoding. Simpan ID ini untuk pemanggilan berikutnya ke operasi API terkait lainnya.

16f01ad6175e4230ac42bb5182cd****

Container

object

Kontainer.

Format

string

Format kontainer.

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": "-1",
        "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.