All Products
Search
Document Center

ApsaraVideo Media Processing:AddTemplate

Last Updated:Feb 25, 2026

Buat template transkoding kustom dengan mengonfigurasi informasi seperti format kontainer, pengaturan aliran video, dan pengaturan aliran audio.

Deskripsi operasi

Saat memanggil operasi ini, Anda harus menetapkan parameter transkoding terkait format kontainer, aliran video, dan aliran audio. Jika beberapa parameter tidak ditentukan, aliran yang dihasilkan menggunakan templat tersebut tidak akan mencakup informasi yang seharusnya ditentukan oleh parameter tersebut.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Kami menyarankan agar Anda mematuhi batas ini saat memanggil operasi ini. 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

*全部资源

*

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. Nilainya harus berupa objek JSON yang berisi parameter Format. Jika Anda tidak menentukan parameter ini, file media hasil transkoding secara default berformat MP4. Parameter ini wajib 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. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat Video.

Catatan

Jika Anda tidak menentukan parameter ini, file output tidak akan berisi aliran video. Parameter ini wajib 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. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat Audio.

Catatan

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

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

TransConfig

string

No

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

{"TransMode":"onepass"}

MuxConfig

string

No

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

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

Container

ParameterTypeRequiredDescription
FormatStringNoNilai 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

ParameterTypeRequiredDescription
CodecStringNoKodek video. Nilai yang valid: H.264, H.265, GIF, dan WebP. Nilai default: H.264.
ProfileStringNoProfil codec. Nilai yang valid: baseline, main, dan high. Nilai default: high. Nilai baseline menunjukkan bahwa file media ditranskoding untuk perangkat seluler. Nilai main menunjukkan bahwa file media ditranskoding untuk perangkat resolusi standar. Nilai high menunjukkan bahwa file media ditranskoding untuk perangkat resolusi tinggi. Jika tersedia beberapa definisi, kami menyarankan agar Anda mengatur parameter ini ke baseline untuk definisi terendah guna memastikan pemutaran normal pada perangkat low-end. Atur parameter ini ke main atau high untuk definisi lainnya. Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.
BitrateStringNoNilai yang valid: 10 hingga 50000. Satuan: Kbit/s.
CrfStringNoFaktor laju konstan (constant rate factor). Nilai yang valid: 0 hingga 51. Nilai default: 26. Jika Anda menentukan parameter ini, pengaturan parameter Bitrate menjadi tidak berlaku.
WidthStringNoLebar video. Nilai yang valid: 128 hingga 4096. Nilai default: lebar video input. Satuan: piksel.
HeightStringNoTinggi video. Nilai yang valid: 128 hingga 4096. Nilai default: tinggi video input. Satuan: piksel.
FpsStringNoLaju frame video. Nilai default: laju frame file input. Nilainya menjadi 60 jika laju frame file input melebihi 60. Nilai yang valid: 0 hingga 60. Satuan: frame per detik.
GopStringNoUkuran GOP (group of pictures). Ukuran GOP dapat berupa interval maksimum keyframe atau jumlah maksimum frame dalam grup frame. Jika Anda menentukan interval maksimum keyframe, satuan (s) wajib dicantumkan. Nilai default: 10s. Jika Anda menentukan jumlah maksimum frame, nilainya tidak memiliki satuan. Nilai yang valid: 1 hingga 100000.
PresetStringNoAlgoritma video preset. Nilai yang valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium. Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.
ScanModeStringNoMode pemindaian. Nilai yang valid: interlaced dan progressive.
BufsizeStringNoUkuran buffer. Nilai yang valid: 1000 hingga 128000. Nilai default: 6000. Satuan: KB.
MaxrateStringNoBitrate maksimum video. Nilai yang valid: 10 hingga 50000. Satuan: Kbit/s.
PixFmtStringNoFormat piksel video. Format piksel standar seperti yuv420p dan yuvj420p didukung. Secara default, digunakan yuv420p atau format piksel video input.
RemoveStringNoMenentukan apakah aliran video dihapus. Nilai true berarti aliran video dihapus. Nilai false berarti aliran video dipertahankan. Nilai default: false.
CropStringNoMetode pemotongan video. Nilai border berarti secara otomatis mendeteksi dan memotong batas hitam. Nilai dalam format width:height:left:top berarti memotong gambar video berdasarkan pengaturan kustom. Contoh: 1280:800:0:140.
PadStringNoBatas hitam yang ditambahkan ke video. Nilainya harus dalam format width:height:left:top. Contoh: 1280:800:0:140.
LongShortModeStringNoMenentukan apakah fitur putar-otomatis diaktifkan. Jika fitur ini diaktifkan, lebar video output sesuai dengan sisi panjang video input, yaitu tinggi video input dalam mode potret. Tinggi video output sesuai dengan sisi pendek video input, yaitu lebar video input dalam mode potret. Nilai true berarti fitur putar-otomatis diaktifkan. Nilai false berarti fitur putar-otomatis dinonaktifkan. Nilai default: false.

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

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 menunjukkan bahwa parameter didukung, sedangkan nilai N menunjukkan bahwa parameter tidak didukung.

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

Audio

ParameterTypeRequiredDescription
CodecStringNoKodek audio. Nilai yang valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.
ProfileStringNoProfil codec audio. Nilai yang valid jika parameter Codec diatur ke AAC: aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.
SamplerateStringNoLaju pengambilan sampel. Nilai yang valid: 22050, 32000, 44100, 48000, dan 96000. Nilai default: 44100. Satuan: Hz. Jika format kontainer video adalah FLV dan kodek audio adalah MP3, laju pengambilan sampel tidak boleh 32000, 48000, atau 96000. Jika kodek audio adalah MP3, laju pengambilan sampel tidak boleh 96000.
BitrateStringNoBitrate audio file output. Nilai yang valid: 8 hingga 1000. Nilai default: 128. Satuan: Kbit/s.
ChannelsStringNoJumlah saluran suara. Nilai default: 2. Nilai yang valid jika parameter Codec diatur ke MP3: 1 dan 2. Nilai yang valid jika parameter Codec diatur ke AAC: 1, 2, 4, 5, 6, dan 8.
RemoveStringNoMenentukan apakah aliran audio dihapus. Nilai true berarti aliran audio dihapus. Nilai false berarti aliran audio dipertahankan. Nilai default: false.

Tabel berikut menjelaskan kombinasi yang didukung antara kodek audio dan format kontainer.

Format kontainerKodek audio
MP3MP3
MP4AAC
OGGVORBIS dan FLAC
FLACFLAC

TransConfig

ParameterTypeRequiredDescription
TransModeStringNoMode transkoding. Nilai yang valid: onepass, twopass, dan CBR. Nilai default: onepass.
AdjDarMethodStringNoMetode penyesuaian resolusi. Nilai yang valid: rescale, crop, pad, dan none. Nilai default: none.
IsCheckResoStringNoMenentukan apakah resolusi diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file output lebih tinggi daripada file input berdasarkan lebar atau tinggi, resolusi file input dipertahankan setelah transkoding. Nilai true berarti resolusi diperiksa. Nilai false berarti resolusi tidak diperiksa. Nilai default: false.
IsCheckResoFailStringNoMenentukan apakah resolusi diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file output lebih tinggi daripada file input berdasarkan lebar atau tinggi, kesalahan yang menunjukkan kegagalan transkoding dikembalikan. Nilai true berarti resolusi diperiksa. Nilai false berarti resolusi tidak diperiksa. Nilai default: false.
IsCheckVideoBitrateStringNoMenentukan apakah bitrate video diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video file output lebih besar daripada file input, bitrate video file input dipertahankan setelah transkoding. Nilai true berarti bitrate video diperiksa. Nilai false berarti bitrate video tidak diperiksa. Nilai default: false.
IsCheckAudioBitrateStringNoMenentukan apakah bitrate audio diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio file output lebih besar daripada file input, bitrate audio file input dipertahankan setelah transkoding. Nilai true berarti bitrate audio diperiksa. Nilai false berarti bitrate audio tidak diperiksa. Nilai default: false.
IsCheckAudioBitrateFailStringNoMenentukan apakah bitrate audio diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio output lebih tinggi daripada audio input, audio input tidak ditranskoding. Nilai true berarti bitrate audio diperiksa. Nilai false berarti bitrate audio tidak diperiksa. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckAudioBitrate.
IsCheckVideoBitrateFailStringNoMenentukan apakah bitrate video diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video output lebih tinggi daripada video input, video input tidak ditranskoding. Nilai true berarti bitrate video diperiksa. Nilai false berarti bitrate video tidak diperiksa. Nilai default: false. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckVideoBitrate.

MuxConfig

ParameterTypeRequiredDescription
SegmentStringNoPengaturan segmen. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat bagian berikut.

Segment

ParameterTypeRequiredDescription
DurationStringNoPanjang segmen. Nilainya harus berupa bilangan bulat. Satuan: detik. Nilai yang valid: 1 hingga 60. Nilai default: 10.
ForceSegTimeStringNoTitik waktu di mana Anda ingin membagi file media. Anda dapat menentukan hingga 10 titik waktu. Pisahkan titik waktu dengan koma (,). Titik waktu dapat akurat hingga tiga tempat desimal. Satuan: detik. Misalnya, jika Anda mengatur parameter ini ke 23,55,60, file media akan dibagi pada detik ke-23, ke-55, dan ke-60.

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

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.

  • Satuan: KB.

6000

LongShortMode

string

Menunjukkan apakah fitur putar-otomatis diaktifkan. Nilai default: false. Nilai yang valid:

  • true: Fitur putar-otomatis diaktifkan.

  • false: Fitur putar-otomatis dinonaktifkan.

Catatan

Jika fitur ini diaktifkan, lebar video output sesuai dengan sisi panjang video input, yaitu tinggi video input dalam mode potret. Tinggi video output sesuai dengan sisi pendek video input, yaitu lebar video input dalam mode potret.

false

Degrain

string

Tingkat kontrol kualitas pada video.

10

BitrateBnd

object

Rentang bitrate video.

Max

string

Bitrate maksimum.

1500

Min

string

Bitrate minimum.

800

PixFmt

string

Format piksel. Format piksel standar seperti yuv420p dan yuvj420p didukung. Format piksel default dapat berupa yuv420p atau format piksel video input.

yuv420p

Pad

string

Batas hitam yang ditambahkan ke video. Nilainya dalam format width:height:left:top.

1280:800:0:140

Codec

string

Kodek video. Nilai yang valid: H.264, H.265, GIF, dan WebP. Nilai default: H.264.

H.264

Height

string

Tinggi video.

  • Satuan: piksel.

  • Nilai default: tinggi video input.

800

Qscale

string

Tingkat algoritma denoising independen.

1

Crop

string

Metode pemotongan video. Nilai yang valid:

  • border: secara otomatis mendeteksi dan menghapus batas.

  • Nilai dalam format width:height:left:top: memotong gambar video berdasarkan pengaturan kustom. Contoh: 1280:800:0:140.

border

Bitrate

string

Bitrate video output. Satuan: Kbit/s.

500

Maxrate

string

Bitrate maksimum video. Satuan: Kbit/s.

500

MaxFps

string

Laju frame maksimum.

60

Profile

string

Profil codec.

  • baseline: cocok untuk perangkat seluler

  • main: cocok untuk perangkat definisi standar

  • high: cocok untuk perangkat definisi tinggi

  • Nilai default: high.

Jika tersedia beberapa definisi, kami menyarankan agar Anda mengatur parameter ini ke baseline untuk definisi terendah guna memastikan pemutaran normal pada perangkat low-end. Atur parameter ini ke main atau high untuk definisi lainnya.

Catatan

Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.

high

Crf

string

Faktor laju konstan. Nilai default jika kodek video diatur ke H.264: 23. Nilai default jika kodek video diatur ke H.265: 26.

Catatan

Jika parameter ini ditentukan, pengaturan parameter Bitrate menjadi tidak berlaku.

15

Remove

string

Menunjukkan apakah aliran video dihapus.

  • true: Aliran video dihapus.

  • false: Aliran video dipertahankan.

  • Nilai default: false.

false

Gop

string

Ukuran GOP. Ukuran GOP dapat berupa interval maksimum keyframe atau jumlah maksimum frame dalam grup frame. Jika interval maksimum ditentukan, nilainya berisi satuan (s). Jika jumlah maksimum frame ditentukan, nilainya tidak berisi satuan. Nilai default: 10s.

10s

Width

string

Lebar video.

  • Nilai default: lebar video input.****

  • Satuan: piksel.

256

Fps

string

Laju frame. Nilai default: laju frame file input. Nilainya menjadi 60 jika laju frame file input melebihi 60. Satuan: frame per detik.

25

Preset

string

Algoritma video preset. Nilai default: medium. Nilai yang valid:

  • veryfast

  • fast

  • medium

  • slow

  • slower

Catatan

Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.

fast

ScanMode

string

Mode pemindaian. Nilai yang valid:

  • interlaced

  • progressive

interlaced

ResoPriority

string

Kebijakan penyesuaian resolusi.

0

Hdr2sdr

string

Menunjukkan apakah fitur konversi HDR2SDR diaktifkan. Jika fitur ini diaktifkan, video high dynamic range (HDR) ditranskoding menjadi video standard dynamic range (SDR).

true

NarrowBand

object

Pengaturan Narrowband HD.

Version

string

Versi Narrowband HD. Hanya 1.0 yang mungkin dikembalikan.

1.0

Abrmax

number

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

3000

MaxAbrRatio

number

Rasio maksimum batas atas bitrate dinamis. Jika parameter ini diatur, nilai Abrmax tidak melebihi x kali bitrate video sumber. Nilai yang valid: (0,1.0].

1.0

TransConfig

object

Pengaturan transkoding umum.

IsCheckAudioBitrate

string

Menunjukkan apakah bitrate audio diperiksa.

Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio file output lebih besar daripada file input, bitrate audio file input dipertahankan setelah transkoding.

  • true: Bitrate audio diperiksa.

  • false: Bitrate audio tidak diperiksa.

  • Nilai default: false.

true

TransMode

string

Mode transkoding. Nilai yang valid:

  • onepass

  • twopass

  • CBR

  • Nilai default: onepass.

onepass

IsCheckReso

string

Menunjukkan apakah resolusi diperiksa.

  • true: Resolusi diperiksa.

  • false: Resolusi tidak diperiksa.

  • Nilai default: false.

Catatan

Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file output lebih tinggi daripada file input berdasarkan lebar atau tinggi, resolusi file input dipertahankan setelah transkoding.

true

IsCheckVideoBitrateFail

string

Menunjukkan apakah bitrate video diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video file output lebih tinggi daripada file input, file input tidak ditranskoding. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckVideoBitrate.

  • true: Bitrate video diperiksa. Dalam hal ini, jika bitrate video file output lebih tinggi daripada file input, file input tidak ditranskoding.

  • false: Bitrate video tidak diperiksa.

  • Nilai default: false.

true

AdjDarMethod

string

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

  • rescale: Video input diskala ulang.

  • crop: Video input dipotong.

  • none: Tidak ada perubahan.

rescale

IsCheckVideoBitrate

string

Menunjukkan apakah bitrate video diperiksa.

  • true: Bitrate video diperiksa.

  • false: Bitrate video tidak diperiksa.

  • Nilai default: false.

Catatan

Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate video file output lebih besar daripada file input, bitrate video file input dipertahankan setelah transkoding.

true

IsCheckResoFail

string

Menunjukkan apakah resolusi diperiksa.

  • true: Resolusi diperiksa.

  • false: Resolusi tidak diperiksa.

  • Nilai default: false.

Catatan

Jika fitur ini diaktifkan dan sistem mendeteksi bahwa resolusi file output lebih tinggi daripada file input berdasarkan lebar atau tinggi, kesalahan yang menunjukkan kegagalan transkoding dikembalikan.

true

IsCheckAudioBitrateFail

string

Menunjukkan apakah bitrate audio diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio file output lebih tinggi daripada file input, file input tidak ditranskoding. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckAudioBitrate. Nilai yang valid:

  • true: Bitrate audio diperiksa. Dalam hal ini, jika bitrate audio file output lebih tinggi daripada file input, file input tidak ditranskoding.

  • false: Bitrate audio tidak diperiksa.

  • Nilai default: false.

true

State

string

Status templat. Nilai yang valid:

  • Normal: Templat normal.

  • Deleted: Templat dihapus.

Normal

MuxConfig

object

Pengaturan transmuxing.

Webp

object

Pengaturan transmuxing untuk WebP.

Loop

string

Jumlah pengulangan.

0

Gif

object

Pengaturan transmuxing untuk GIF.

FinalDelay

string

Durasi jeda bingkai terakhir. Satuan: sentidetik.

0

DitherMode

string

Algoritma dithering warna palet. Nilai yang valid: sierra dan bayer.

sierra

Loop

string

Jumlah pengulangan.

0

IsCustomPalette

string

Menunjukkan apakah palet kustom digunakan.

false

Segment

object

Pengaturan segmen.

Duration

string

Panjang segmen. Satuan: detik.

10

Name

string

Nama template transkoding.

mps-example

Audio

object

Konfigurasi kodek audio.

Profile

string

Profil codec audio. Nilai yang valid jika parameter Codec diatur ke AAC:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

  • aac_eld

aac_low

Remove

string

Menunjukkan apakah aliran audio dihapus.

  • true: Aliran audio dihapus.

  • false: Aliran audio dipertahankan.

  • Nilai default: false.

true

Codec

string

Format kodek audio. Nilai default: aac. Nilai yang valid:

  • aac

  • mp3

  • vorbis

  • flac

aac

Samplerate

string

Laju pengambilan sampel.

  • Satuan: Hz.

  • Nilai default: 44100.

44100

Qscale

string

Tingkat algoritma denoising independen.

5

Channels

string

Jumlah saluran suara. Nilai default: 2.

2

Volume

object

Konfigurasi kontrol volume

Method

string

Metode penyesuaian volume. Nilai yang valid:

  • auto: Volume disesuaikan secara otomatis.

  • dynamic: Volume disesuaikan secara dinamis.

  • linear: Volume disesuaikan secara linear.

auto

Level

string

Rentang penyesuaian volume.

  • Nilai default: -20.

  • Satuan: dB.

-20

IntegratedLoudnessTarget

string

Volume output.

Parameter ini hanya berlaku ketika nilai Method adalah dynamic.

Satuan: dB.

Nilai yang valid: [-70,-5].

Nilai default: -6.

-6

TruePeak

string

Volume puncak.

Parameter ini hanya berlaku ketika nilai Method adalah dynamic.

Satuan: dB.

Nilai yang valid: [-9,0].

Nilai default: -1.

0

LoudnessRangeTarget

string

Rentang volume relatif terhadap volume output.

Parameter ini hanya berlaku ketika nilai Method adalah dynamic.

Satuan: dB.

Nilai yang valid: [1,20].

Nilai default: 8.

8

PeakLevel

string

Koefisien penyesuaian volume.

Parameter ini hanya berlaku ketika nilai Method adalah adaptive.

Nilai yang valid: [0,1].

Nilai default: 0.9.

0.9

Bitrate

string

Bitrate audio file output.

  • Satuan: Kbit/s.

  • Nilai default: 128.

500

Id

string

ID template transkoding. Kami menyarankan agar Anda menyimpan ID ini untuk panggilan operasi selanjutnya.

16f01ad6175e4230ac42bb5182cd****

Container

object

Pengaturan format 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": "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.