All Products
Search

This Product

    ApsaraVideo Media Processing:SearchTemplate

    Document Center

    ApsaraVideo Media Processing:SearchTemplate

    Last Updated:Feb 25, 2026

    Anda dapat memanggil operasi ini untuk mengkueri template transkoding kustom dalam status tertentu.

    Deskripsi operasi

    Operasi ini dapat dipanggil hingga 100 kali per detik. Jika jumlah panggilan melebihi batas tersebut, pembatasan kecepatan (throttling) akan diterapkan dan berpotensi mengganggu bisnis Anda. Pastikan untuk memperhatikan batas ini saat melakukan pemanggilan. 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:SearchTemplate

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PageSize

    integer

    No

    Ukuran setiap halaman yang ditetapkan selama kueri hasil dengan paging.

    • Batas atas: 100.

    • Nilai default: 10.

    10
    PageNumber

    integer

    No

    Nomor halaman yang dikembalikan. Nilai default: 1.

    1
    State

    string

    No

    Status template transkoding kustom yang ingin Anda kueri.

    • All: Semua template transkoding kustom dikueri.

    • Normal: Template transkoding kustom dalam status Normal dikueri.

    • Deleted: Template transkoding kustom yang telah dihapus dikueri.

    • Nilai default: All.

    Normal
    NamePrefix

    string

    No

    Awalan nama berdasarkan mana Anda ingin mencari template.

    S00000001

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    TotalCount

    integer

    Jumlah total hasil pencarian.

    1
    TemplateList

    object

    Template

    array<object>

    Template 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 bitrate total. Unit: Kbit/s.

    500
    Min

    string

    Batas bawah bitrate total. Unit: Kbit/s.

    100
    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 yang valid: H.264 dan H.265.

    • 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 gambar 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
    NarrowBand

    object

    Pengaturan Narrowband HD.

    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
    Version

    string

    Versi Narrowband HD. Hanya 1.0 yang mungkin dikembalikan.

    1.0
    MaxFps

    string

    Laju frame maksimum.

    60
    Profile

    string

    Profil codec. 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 (constant rate factor).

    • Nilai default ketika nilai Codec adalah H.264: 23, nilai default ketika nilai Codec 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.

    • Nilai yang valid: [128,4096].

    • Unit: piksel.

    • Nilai default: lebar video input.

    256
    Fps

    string

    Laju frame video.

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

    • Nilai default: laju frame video input.

    25
    Preset

    string

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

    • veryfast

    • fast

    • medium

    • slow

    • slower

    medium
    ScanMode

    string

    Mode pemindaian. Nilai yang valid:

    • interlaced

    • progressive

    interlaced
    ResoPriority

    string

    Kebijakan penyesuaian resolusi.

    1
    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
    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 dibanding IsCheckAudioBitrateFail. Nilai yang valid:

    • true

    • false

    • Nilai default:

      • Jika parameter ini kosong dan kodek audio output berbeda dari kodek audio input, nilai default-nya adalah false.

      • Jika parameter ini kosong dan kodek audio output sama dengan kodek audio input, nilai default-nya 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 error pemeriksaan bitrate video diperbolehkan. Parameter ini memiliki prioritas lebih tinggi dibanding 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, akan dikembalikan kegagalan transkoding. Nilai yang valid:

    • true

    • false

    • Nilai default: false.

    false
    IsCheckAudioBitrateFail

    string

    Menunjukkan apakah error pemeriksaan bitrate audio diperbolehkan. Parameter ini memiliki prioritas lebih tinggi dibanding 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 template. Nilai yang valid:

    • Normal

    • Deleted

    Normal
    MuxConfig

    object

    Konfigurasi transmuxing.

    Gif

    object

    Konfigurasi transmuxing untuk GIF.

    FinalDelay

    string

    Durasi jeda pada frame terakhir. Unit: 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

    Konfigurasi segmen.

    Duration

    string

    Panjang segmen. Unit: detik.

    10
    Name

    string

    Nama template.

    MPS-example
    Audio

    object

    Konfigurasi kodek audio.

    Profile

    string

    Profil kodek 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 kodek 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. Nilai yang valid: [1,9].

    1
    Channels

    string

    Jumlah saluran suara. Nilai default: 2.

    2
    Bitrate

    string

    Bitrate audio file output.

    • Unit: Kbit/s.

    • Nilai default: 128.

    500
    Id

    string

    ID template transkoding.

    16f01ad6175e4230ac42bb5182cd****
    Container

    object

    Konfigurasi format kontainer.

    Format

    string

    Format kontainer. Nilai yang valid:

    • flv

    • mp4

    • ts

    • m3u8

    • gif

    • mp3

    • ogg

    • flac

    mp4
    CreationTime

    string

    Waktu saat template dibuat.

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

    integer

    Nomor halaman dari halaman yang dikembalikan.

    10
    RequestId

    string

    ID permintaan.

    BC860F04-778A-472F-AB39-E1BF329C****
    PageNumber

    integer

    Nomor halaman yang dikembalikan.

    1

    Contoh

    Respons sukses

    JSONformat

    {
  "TotalCount": 1,
  "TemplateList": {
    "Template": [
      {
        "Video": {
          "Bufsize": "6000",
          "LongShortMode": "false",
          "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",
          "NarrowBand": {
            "Abrmax": 3000,
            "MaxAbrRatio": 1,
            "Version": "1.0"
          },
          "MaxFps": "60",
          "Profile": "high",
          "Crf": "15",
          "Remove": "false",
          "Gop": "10",
          "Width": "256",
          "Fps": "25",
          "Preset": "medium",
          "ScanMode": "interlaced",
          "ResoPriority": "1",
          "Hdr2sdr": "true"
        },
        "TransConfig": {
          "IsCheckAudioBitrate": "false",
          "TransMode": "onepass",
          "IsCheckReso": "false",
          "IsCheckVideoBitrateFail": "false",
          "AdjDarMethod": "none",
          "IsCheckVideoBitrate": "false",
          "IsCheckResoFail": "false",
          "IsCheckAudioBitrateFail": "false"
        },
        "State": "Normal",
        "MuxConfig": {
          "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"
        },
        "Id": "16f01ad6175e4230ac42bb5182cd****",
        "Container": {
          "Format": "mp4"
        },
        "CreationTime": "2021-03-04T06:44:43Z"
      }
    ]
  },
  "PageSize": 10,
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C****",
  "PageNumber": 1
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.