All Products
Search

This Product

    ApsaraVideo Media Processing:QueryTemplateList

    Document Center

    ApsaraVideo Media Processing:QueryTemplateList

    Last Updated:Feb 25, 2026

    Anda dapat memanggil operasi ini untuk mengkueri hingga 10 templat transkoding sekaligus.

    Deskripsi operasi

    ID templat transkoding yang ingin Anda kueri. Anda dapat mengkueri hingga 10 templat transkoding sekaligus. Pisahkan beberapa ID templat transkoding kustom dengan koma (,).

    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:QueryTemplateList

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    TemplateIds

    string

    Yes

    Parameter respons.

    16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    NonExistTids

    object

    String

    array

    ID templat yang tidak ada. Parameter ini tidak dikembalikan jika semua templat transkoding yang ditentukan ditemukan.

    string

    Detail templat transkoding.

    88c6ca184c0e424d5w5b665e2a12****
    TemplateList

    object

    Template

    array<object>

    Templat transkoding.

    array<object>

    Konfigurasi kodek video.

    Video

    object

    Konfigurasi kodek video.

    Bufsize

    string

    Ukuran buffer.

    • Unit: KB.

    • Nilai default: 6000.

    6000
    LongShortMode

    string

    Menunjukkan apakah fitur putar-otomatis layar 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 yang valid:

    • true

    • false

    • Nilai default: false.

    false
    Degrain

    string

    Tingkat kontrol kualitas video.

    10
    BitrateBnd

    object

    Rentang bitrate rata-rata video.

    Max

    string

    Batas atas total bitrate. Unit: Kbit/s.

    100
    Min

    string

    Batas bawah total bitrate. Unit: Kbit/s.

    500
    PixFmt

    string

    Format piksel video. Nilai yang valid: format piksel standar seperti yuv420p dan yuvj420p.

    yuv420p
    Pad

    string

    Bilah hitam yang ditambahkan ke video. Format: width:height:left:top. Contoh: 1280:800:0:140.

    1280:800:0:140
    Codec

    string

    Kodek. Nilai default: H.264.

    H.264
    Height

    string

    Tinggi video.

    • Unit: piksel.

    • Nilai default: tinggi video input.

    800
    Qscale

    string

    Kekuatan algoritma penghilangan derau independen.

    1
    Crop

    string

    Metode pemotongan video. Nilai yang valid:

    • border: secara otomatis mendeteksi dan menghapus bilah hitam.

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

    border
    Bitrate

    string

    Bitrate rata-rata video. Unit: Kbit/s.

    200
    Maxrate

    string

    Bitrate maksimum video. Unit: Kbit/s.

    500
    MaxFps

    string

    Laju frame maksimum.

    60
    Profile

    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.

    high
    Crf

    string

    Faktor laju konstan.

    • Nilai default saat format encoding adalah H.264: 23. Nilai default saat format encoding adalah H.265: 26.

    • Jika parameter ini diatur, nilai Bitrate menjadi tidak berlaku.

    15
    Remove

    string

    Menunjukkan apakah aliran video dihapus. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    Gop

    string

    Jumlah maksimum frame antara dua keyframe. Nilai default: 250.

    10
    Width

    string

    Lebar video.

    • Unit: piksel.

    • Nilai default: lebar video input.

    256
    Fps

    string

    Laju frame.

    • Nilainya adalah 60 jika laju frame file input melebihi 60.

    • Nilai default: laju frame file input.

    25
    Preset

    string

    Algoritma video preset. Nilai yang valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium.

    medium
    ScanMode

    string

    Mode pemindaian. Nilai yang valid:

    • interlaced

    • progressive

    interlaced
    ResoPriority

    string

    Kebijakan penyesuaian resolusi. Nilai yang valid: cropFirst, widthFirst, dan heightFirst.

    heightFirst
    Hdr2sdr

    string

    Menunjukkan apakah fitur konversi HDR2SDR diaktifkan. Jika fitur ini diaktifkan, video high dynamic range (HDR) akan ditranskod ke 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

    Konfigurasi transkoding umum.

    IsCheckAudioBitrate

    string

    Menunjukkan apakah bitrate audio diperiksa. Jika bitrate audio output lebih tinggi daripada bitrate audio input, bitrate input dipertahankan dan bitrate audio yang ditentukan tidak berlaku. Parameter ini memiliki prioritas lebih rendah daripada IsCheckAudioBitrateFail. Nilai yang valid:

    • true

    • false

    • Nilai default:

      • Jika parameter ini tidak ditentukan dan kodek audio output berbeda dari kodek audio input, nilai default adalah false.

      • Jika parameter ini tidak ditentukan dan kodek audio output sama dengan kodek audio input, nilai default adalah true.

    false
    TransMode

    string

    Mode transkoding. Nilai default: onepass. Nilai yang valid:

    • onepass

    • twopass

    • CBR

    onepass
    IsCheckReso

    string

    Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, resolusi input dipertahankan. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    IsCheckVideoBitrateFail

    string

    Menunjukkan apakah kesalahan pemeriksaan bitrate video diperbolehkan. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckVideoBitrate. Nilai yang valid:

    • true: Jika pemeriksaan bitrate video gagal, file input tidak ditranskod.

    • false: Bitrate video tidak diperiksa.

    • Nilai default: false.

    false
    AdjDarMethod

    string

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

    • rescale

    • crop

    • none

    none
    IsCheckVideoBitrate

    string

    Menunjukkan apakah bitrate video diperiksa. Jika bitrate video output lebih tinggi daripada bitrate video input, bitrate input dipertahankan. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    IsCheckResoFail

    string

    Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding dikembalikan. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    IsCheckAudioBitrateFail

    string

    Menunjukkan apakah kesalahan pemeriksaan bitrate audio diperbolehkan. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckAudioBitrate. Nilai yang valid:

    • true: Jika pemeriksaan bitrate audio gagal, file input tidak ditranskod.

    • false: Bitrate audio tidak diperiksa.

    • Nilai default: false.

    false
    State

    string

    Status templat. Nilai yang valid:

    • Normal

    • Deleted

    Normal
    MuxConfig

    object

    Konfigurasi transmuxing.

    Webp

    object

    Konfigurasi transmuxing untuk WebP.

    Loop

    string

    Jumlah pengulangan.

    0
    Gif

    object

    Konfigurasi transmuxing untuk GIF.

    FinalDelay

    string

    Durasi jeda pada frame terakhir.

    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

    Konfigurasi segmen.

    Duration

    string

    Panjang segmen. Unit: detik.

    10
    Name

    string

    Nama templat.

    MPS-example
    Audio

    object

    Konfigurasi kodek audio.

    Profile

    string

    Profil codec audio. Nilai yang valid ketika nilai Codec adalah aac:

    • aac_low

    • aac_he

    • aac_he_v2

    • aac_ld

    • aac_eld

    aac_low
    Remove

    string

    Menunjukkan apakah aliran audio dihapus. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    Codec

    string

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

    • aac

    • mp3

    • vorbis

    • flac

    aac
    Samplerate

    string

    Laju pengambilan sampel.

    • Unit: Hz

    • Nilai default: 44100.

    44100
    Qscale

    string

    Kekuatan algoritma penghilangan derau independen.

    1
    Channels

    string

    Jumlah saluran suara. Nilai default: 2.

    2
    Bitrate

    string

    Bitrate audio file output.

    • Nilai yang valid: [8,1000].

    • Unit: Kbit/s.

    • Nilai default: 128.

    500
    Volume

    object

    Konfigurasi kontrol volume.

    Method

    string

    Metode yang digunakan untuk menyesuaikan volume. Nilai yang valid:

    • auto

    • dynamic

    • linear

    • Nilai default: dynamic.

    auto
    TruePeak

    string

    Volume puncak.

    • Parameter ini hanya berlaku jika nilai Method adalah dynamic.

    • Unit: dB.

    • Nilai yang valid: [-9,0].

    • Nilai default: -1.

    -1
    IntegratedLoudnessTarget

    string

    Volume output.

    • Parameter ini hanya berlaku jika nilai Method adalah dynamic.

    • Unit: dB.

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

    • Nilai default: -6.

    -6
    LoudnessRangeTarget

    string

    Rentang volume relatif terhadap volume output.

    • Parameter ini hanya berlaku jika nilai Method adalah dynamic.

    • Unit: dB.

    • Nilai yang valid: [1,20].

    • Nilai default: 8.

    8
    Level

    string

    Volume yang ditingkatkan relatif terhadap volume audio input.

    • Parameter ini hanya berlaku jika nilai Method adalah linear.

    • Unit: dB.

    • Nilai yang valid: kurang dari atau sama dengan 20.

    • Nilai default: -20.

    -20
    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

    ID templat transkoding.

    16f01ad6175e4230ac42bb5182cd****
    Container

    object

    Konfigurasi format kontainer.

    Format

    string

    Format kontainer. Nilai yang valid: flv, mp4, ts, m3u8, gif, mp3, ogg, dan flac.

    flv
    CreationTime

    string

    Waktu pembuatan templat.

    2021-03-04T06:44:43Z
    RequestId

    string

    ID permintaan.

    BC860F04-778A-472F-AB39-E1BF329C1EA8

    Contoh

    Respons sukses

    JSONformat

    {
  "NonExistTids": {
    "String": [
      "88c6ca184c0e424d5w5b665e2a12****"
    ]
  },
  "TemplateList": {
    "Template": [
      {
        "Video": {
          "Bufsize": "6000",
          "LongShortMode": "false",
          "Degrain": "10",
          "BitrateBnd": {
            "Max": "100",
            "Min": "500"
          },
          "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": "heightFirst",
          "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": "0",
            "DitherMode": "sierra",
            "Loop": "0",
            "IsCustomPalette": "false"
          },
          "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",
            "LoudnessRangeTarget": "8",
            "Level": "-20",
            "PeakLevel": "0.9"
          }
        },
        "Id": "16f01ad6175e4230ac42bb5182cd****",
        "Container": {
          "Format": "flv"
        },
        "CreationTime": "2021-03-04T06:44:43Z"
      }
    ]
  },
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C1EA8"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.