Gunakan UpdateTemplate untuk memodifikasi template transkode kustom - ApsaraVideo Media Processing

Perbarui pengaturan template transkoding kustom.

Deskripsi operasi

Jika terdapat pekerjaan dengan status "Submitted" yang menggunakan template kustom ini, pengaturan template transkoding terkait tidak dapat diperbarui.

Batas QPS

Batas permintaan per detik (QPS) untuk API ini adalah 100 permintaan per detik per pengguna. Jika batas tersebut dilampaui, panggilan API akan dikenai Pembatasan laju, yang dapat berdampak pada bisnis Anda. Harap panggil API secara tepat. 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:UpdateTemplate

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TemplateId	string	Yes	Nama template. Nama dapat memiliki panjang hingga 128 byte.	16f01ad6175e4230ac42bb5182cd****
Name	string	Yes	Format kontainer. Nilainya berupa objek JSON. Format default: MP4. Format video: FLV, MP4, HLS (M3U8 + TS), dan MPEG-DASH (MPD + fMP4) Format audio: MP3, MP4, OGG, FLAC, dan M4A Format gambar: GIF dan WebP Untuk informasi selengkapnya, lihat parameter Container pada topik "Detail Parameter".	MPS-example
Container	string	No	Konfigurasi aliran video. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat parameter Video pada topik "Detail Parameter".	{"Format":"mp4"}
Video	string	No	Konfigurasi aliran audio. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat parameter Audio pada topik "Detail Parameter".	{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10"}
Audio	string	No	Konfigurasi transmuxing. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat parameter MuxConfig pada topik "Detail Parameter".	{"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}
MuxConfig	string	No	Konfigurasi transkoding umum. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat parameter TransConfig pada topik "Detail Parameter".	{"Segment":{"Duration":"10"}}
TransConfig	string	No	ID permintaan.	{"TransMode":"onepass"}

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	Jenis template transkoding.	5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21
Template	object	Jenis template transkoding.
Video	object	Konfigurasi kodek video.
LongShortMode	string	Ukuran buffer. Unit: KB. Nilai default: 6000.	false
Bufsize	string	Tingkat kontrol kualitas pada video.	6000
Degrain	string	Rentang bitrate rata-rata video.	10
BitrateBnd	object	Batas atas total bitrate. Unit: Kbit/s.
Max	string	Batas bawah total bitrate. Unit: Kbit/s.	500
Min	string	Format piksel. Nilai yang valid: format piksel standar seperti yuv420p dan yuvj420p.	100
PixFmt	string	Batas hitam yang ditambahkan ke video. Format: width:height:left:top. Contoh: 1280:800:0:140.	yuv420p
Pad	string	Kodek video. Nilai default: H.264.	1280:800:0:140
Codec	string	Tinggi video output. Unit: piksel. Nilai default: tinggi video input.	H.264
Height	string	Tingkat algoritma penghilangan derau independen.	800
Qscale	string	Metode yang digunakan untuk memotong video. border: mendeteksi dan menghapus batas secara otomatis. Nilai dalam format width:height:left:top: memotong video berdasarkan pengaturan kustom.**** Contoh: 1280:800:0:140.	1
Crop	string	Bitrate rata-rata video. Unit: Kbit/s.	border
Bitrate	string	Bitrate maksimum video. Unit: Kbit/s.	200
Maxrate	string	Laju frame maksimum.	500
MaxFps	string	Profil pengkodean. Nilai yang valid: baseline: berlaku untuk perangkat seluler. main: berlaku untuk perangkat definisi standar. high: berlaku untuk perangkat definisi tinggi. Nilai default: high.	60
Profile	string	Faktor kontrol kualitas bitrate. Nilai default jika parameter Codec diatur ke H.264: 23. Nilai default jika parameter Codec diatur ke H.265: 26. Jika parameter ini dikembalikan, pengaturan parameter Bitrate tidak berlaku.	high
Crf	string	Menunjukkan apakah aliran video dihapus. Nilai yang valid: true: Aliran video dihapus. false: Aliran video dipertahankan. Nilai default: false.	15
Remove	string	Jumlah maksimum frame antara dua keyframe. Nilai default: 250.	false
Gop	string	Lebar video. Unit: piksel. Nilai default: lebar video input.	10
Width	string	Laju frame. Nilai 60 dikembalikan jika laju frame video input melebihi 60. Nilai default: laju frame video input.	256
Fps	string	Algoritma video preset. Nilai default: medium. Nilai yang valid: veryfast fast medium slow slower	25
Preset	string	Mode pemindaian. Nilai yang valid: interlaced: Dilakukan pemindaian interlaced. progressive: Dilakukan pemindaian progressive.	medium
ScanMode	string	Kebijakan penyesuaian resolusi.	interlaced
ResoPriority	string	Konfigurasi transkoding umum.	1
Hdr2sdr	string	Menunjukkan apakah fitur konversi HDR2SDR diaktifkan. Jika fitur ini diaktifkan, video high dynamic range (HDR) akan ditranskode 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	Menunjukkan apakah bitrate audio diperiksa. Jika bitrate audio output lebih besar daripada bitrate audio input, bitrate audio input akan dipertahankan setelah transkoding. Dalam hal ini, bitrate audio yang ditentukan tidak berlaku. Parameter ini memiliki prioritas lebih rendah dibandingkan parameter IsCheckAudioBitrateFail. Nilai yang valid: true: Bitrate audio diperiksa. false: Bitrate audio tidak diperiksa. Nilai default: Jika parameter dibiarkan kosong dan kodek audio output berbeda dari kodek audio input, nilai default-nya false. Jika parameter dibiarkan kosong dan kodek audio output sama dengan kodek audio input, nilai default-nya true.
IsCheckAudioBitrate	string	Mode transkoding. Nilai default: onepass. Nilai yang valid: onepass twopass CBR	false
TransMode	string	Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, resolusi input akan dipertahankan setelah transkoding. Nilai yang valid: true: Resolusi diperiksa. false: Resolusi tidak diperiksa. Nilai default: false.	onepass
IsCheckReso	string	Menunjukkan apakah bitrate video diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckVideoBitrate. Nilai yang valid: true: Bitrate video diperiksa false: Bitrate video tidak diperiksa. Nilai default: false.	false
IsCheckVideoBitrateFail	string	Metode penyesuaian resolusi. Nilai default: none. Nilai yang valid: rescale: Video input diskalakan ulang. crop: Video input dipotong. none: Tidak ada perubahan.	false
AdjDarMethod	string	Menunjukkan apakah bitrate video diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa bitrate video file output lebih besar daripada file input, bitrate video file input akan dipertahankan setelah transkoding. Nilai yang valid: true: Bitrate video diperiksa. false: Bitrate video tidak diperiksa. Nilai default: false.	none
IsCheckVideoBitrate	string	Menunjukkan apakah resolusi diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa resolusi file output lebih tinggi daripada file input berdasarkan lebar atau tinggi, kesalahan yang menunjukkan kegagalan transkoding akan dikembalikan. Nilai yang valid: true: Resolusi diperiksa. false: Resolusi tidak diperiksa. Nilai default: false.	false
IsCheckResoFail	string	Menunjukkan apakah bitrate audio diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckAudioBitrate. Nilai yang valid: true: Bitrate audio diperiksa. false: Bitrate audio tidak diperiksa. Nilai default: false.	false
IsCheckAudioBitrateFail	string	Status template. Nilai yang valid: Normal: Template normal. Deleted: Template dihapus.	false
State	string	Konfigurasi transmuxing.	Normal
MuxConfig	object	Konfigurasi transmuxing untuk WebP.
Webp	object	Jumlah loop.
Loop	string	Konfigurasi transmuxing untuk GIF.	0
Gif	object	Durasi jeda pada frame terakhir. Unit: milidetik.
FinalDelay	string	Algoritma dithering warna palet. Nilai yang valid: sierra dan bayer.	false
DitherMode	string	Jumlah loop.	bayer
Loop	string	Menunjukkan apakah palet kustom digunakan.	0
IsCustomPalette	string	Konfigurasi segmen.	0
Segment	object	Panjang segmen. Unit: detik.
Duration	string	Nama template.	10
Name	string	Konfigurasi kodek audio.	MPS-example
Audio	object	Pengaturan kodek audio.
Profile	string	Menunjukkan apakah aliran audio dihapus. true: Aliran audio dihapus. false: Aliran audio dipertahankan. Nilai default: false.	aac_low
Remove	string	Format kodek audio. Nilai default: aac. Nilai yang valid: aac mp3 vorbis flac	false
Codec	string	Laju pengambilan sampel. Unit: Hz. Nilai default: 44100.	aac
Samplerate	string	Tingkat algoritma penghilangan derau independen.	44100
Qscale	string	Jumlah saluran suara. Nilai default: 2.	1
Channels	string	Bitrate audio file output. Nilai yang valid: 8 hingga 1000.** Unit: Kbit/s. Nilai default: 128**.	2
Bitrate	string	ID template transkoding.	500
Volume	object	Konfigurasi kontrol volume.
Method	string	Metode penyesuaian volume. Nilai yang valid: auto dynamic linear	auto
TruePeak	string	Volume puncak. Parameter ini hanya berlaku jika nilai Method adalah dynamic. Unit: desibel. Nilai yang valid: [-9,0]. Nilai default: -1.	-1
IntegratedLoudnessTarget	string	Volume yang diharapkan. Parameter ini hanya berlaku jika nilai Method adalah dynamic. Unit: desibel. Nilai yang valid: [-70,-5]. Nilai default: -6.	-6
Level	string	Volume yang ditingkatkan relatif terhadap volume audio input. Parameter ini hanya berlaku jika nilai Method adalah linear. Unit: desibel. Nilai yang valid: kurang dari atau sama dengan 20. Nilai default: -20.	-20
LoudnessRangeTarget	string	Rentang volume relatif terhadap volume yang diharapkan. Parameter ini hanya berlaku jika nilai Method adalah dynamic. Unit: desibel. Nilai yang valid: [1,20]. Nilai default: 8.	8
PeakLevel	string	Koefisien penyesuaian volume. Parameter ini hanya berlaku jika nilai Method adalah adaptive. Nilai yang valid: [0,1]. Nilai default: 0.9.	0.9
Id	string	Konfigurasi kontainer.	16f01ad6175e4230ac42bb5182cd****
Container	object	Format kontainer.
Format	string	Format kontainer.	mp4

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.