All Products
Search
Document Center

:UpdateTemplate

Last Updated:May 27, 2026

Memperbarui template transkoding kustom.

Catatan penggunaan

Template transkoding kustom tidak dapat diperbarui jika sedang digunakan oleh pekerjaan yang telah dikirim.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik. Jika jumlah panggilan per detik melebihi batas tersebut, pembatasan kecepatan (throttling) akan diterapkan dan berpotensi mengganggu bisnis Anda. Oleh karena itu, pastikan Anda mematuhi batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer, yang secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter Type Wajib Contoh Deskripsi
Action String Ya UpdateTemplate

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke UpdateTemplate.

TemplateId String Ya 16f01ad6175e4230ac42bb5182cd****

ID template. Anda dapat memperoleh ID template dari respons operasi AddTemplate.

Name String Ya MPS-example

Nama template. Panjang nama maksimal 128 byte.

Container String Tidak {"Format":"mp4"}

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 bagian "Container" pada topik Detail parameter.

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

Konfigurasi aliran video. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian "Videor" pada topik Detail parameter.

Audio String Tidak {"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}

Konfigurasi aliran audio. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian "Audio" pada topik Detail parameter.

MuxConfig String Tidak {"Segment":{"Duration":"10"}}

Konfigurasi transmuxing. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian "MuxConfig" pada topik Detail parameter.

TransConfig String Tidak {"TransMode":"onepass"}

Konfigurasi transkoding umum. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian "TransConfig" pada topik Detail parameter.

Parameter respons

Parameter Type Contoh Deskripsi
RequestId String 5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21

ID permintaan.

Template Object

Jenis template transkoding.

Video Object

Konfigurasi kodek video.

LongShortMode String false

Menunjukkan apakah fitur auto-rotate screen diaktifkan.

  • Jika fitur ini diaktifkan, lebar video output sesuai dengan sisi panjang video input, yaitu tinggi video input dalam mode portrait. Tinggi video output sesuai dengan sisi pendek video input, yaitu lebar video input dalam mode portrait.
  • true: Fitur auto-rotate screen diaktifkan.
  • false: Fitur auto-rotate screen dinonaktifkan.
  • Nilai default: false.
Bufsize String 6000

Ukuran buffer.

  • Unit: KB.
  • Nilai default: 6000.
Degrain String 10

Tingkat kontrol kualitas pada video.

BitrateBnd Object

Rentang bitrate rata-rata video.

Max String 500

Batas atas total bitrate. Unit: Kbit/s.

Min String 100

Batas bawah total bitrate. Unit: Kbit/s.

PixFmt String yuv420p

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

Pad String 1280:800:0:140

Batas hitam yang ditambahkan ke video.

  • Format: width:height:left:top.
  • Contoh: 1280:800:0:140.
Codec String H.264

Kodek video. Nilai default: H.264.

Height String 800

Tinggi video output.

  • Unit: piksel.
  • Nilai default: tinggi video input.
Qscale String 1

Kekuatan algoritma noise reduction independen.

Crop String border

Metode yang digunakan untuk memotong video. Nilai yang valid:

  • border: mendeteksi dan menghapus border secara otomatis.
  • Nilai lain: mode pemotongan kustom. Format: width:height:left:top. Contoh: 1280:800:0:140.
Bitrate String 200

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

Maxrate String 500

Bitrate maksimum video output. Unit: Kbit/s.

MaxFps String 60

Laju frame maksimum.

Profile String high

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.
Crf String 15

Faktor kontrol kualitas bitrate.

  • Nilai default ketika parameter Codec diatur ke H.264: 23. Nilai default ketika parameter Codec diatur ke H.265: 26.
  • Jika parameter ini ditentukan, pengaturan parameter Bitrate tidak berlaku.
Remove String false

Menunjukkan apakah aliran video dihapus. Nilai yang valid:

  • true: Aliran video dihapus.
  • false: Aliran video dipertahankan.
  • Nilai default: false.
Gop String 10

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

Width String 256

Lebar video.

  • Unit: piksel.
  • Nilai default: lebar video asli.
Fps String 25

Laju frame.

  • Nilai 60 dikembalikan jika laju frame video input melebihi 60.
  • Nilai default: laju frame video input.
Preset String medium

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

  • veryfast
  • fast
  • medium
  • slow
  • slower
ScanMode String interlaced

Mode pemindaian. Nilai yang valid:

  • interlaced: Dilakukan pemindaian interlaced.
  • progressive: Dilakukan pemindaian progressive.
ResoPriority String 1

Kebijakan penyesuaian resolusi.

TransConfig Object

Konfigurasi transkoding umum.

IsCheckAudioBitrate String false

Menunjukkan apakah bitrate audio diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa bitrate audio output lebih besar daripada bitrate audio input, bitrate audio input dipertahankan setelah transkoding. Dalam kasus 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 adalah false.
    • Jika parameter dibiarkan kosong dan kodek audio output sama dengan kodek audio input, nilai default adalah true.
TransMode String onepass

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

  • onepass
  • twopass
  • CBR
IsCheckReso String false

Menunjukkan apakah resolusi diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, sistem menganggap bahwa resolusi output sama dengan resolusi input.

  • true: Resolusi diperiksa.
  • false: Resolusi tidak diperiksa.
  • Nilai default: false.
IsCheckVideoBitrateFail String false

Menunjukkan apakah bitrate video diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckVideoBitrate.

  • true: Bitrate video diperiksa.
  • false: Bitrate video tidak diperiksa.
  • Nilai default: false.
AdjDarMethod String none

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

  • rescale: Video input di-rescale.
  • crop: Video input dipotong.
  • none: Tidak ada perubahan.
IsCheckVideoBitrate String false

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 dipertahankan setelah transkoding. Nilai yang valid:

  • true: Bitrate video diperiksa.
  • false: Bitrate video tidak diperiksa.
  • Nilai default: false.
IsCheckResoFail String false

Menunjukkan apakah resolusi diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding akan dikembalikan.

  • true: Resolusi diperiksa.
  • false: Resolusi tidak diperiksa.
  • Nilai default: false.
IsCheckAudioBitrateFail String false

Menunjukkan apakah bitrate audio diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckAudioBitrate.

  • true: Bitrate audio diperiksa.
  • false: Bitrate audio tidak diperiksa.
  • Nilai default: false.
State String Normal

Status template. Nilai yang valid:

  • Normal: Template normal.
  • Deleted: Template dihapus.
MuxConfig Object

Konfigurasi transmuxing.

Webp Object

Konfigurasi transmuxing untuk WebP.

Loop String 0

Jumlah loop.

Gif Object

Konfigurasi transmuxing untuk GIF.

FinalDelay String false

Durasi jeda pada frame terakhir. Unit: milidetik.

DitherMode String bayer

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

Loop String 0

Jumlah loop.

IsCustomPalette String 0

Menunjukkan apakah palet kustom digunakan.

Segment Object

Konfigurasi segmen.

Duration String 10

Panjang segmen. Unit: detik.

Name String MPS-example

Nama template.

Audio Object

Konfigurasi kodek audio.

Profile String aac_low

Profil codec audio. Nilai yang valid ketika parameter Codec diatur ke aac:

  • aac_low
  • aac_he
  • aac_he_v2
  • aac_ld
  • aac_eld
Remove String false

Menunjukkan apakah aliran audio dihapus. Nilai yang valid:

  • true: Aliran audio dihapus.
  • false: Aliran audio dipertahankan.
  • Nilai default: false.
Codec String aac

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

  • aac
  • mp3
  • vorbis
  • flac
Samplerate String 44100

Laju pengambilan sampel.

  • Unit: Hz.
  • Nilai default: 44100.
Qscale String 1

Kekuatan algoritma noise reduction independen.

Channels String 2

Jumlah saluran suara. Nilai default: 2.

Bitrate String 500

Bitrate audio file output.

  • Nilai yang valid: [8, 1000].
  • Unit: Kbit/s.
  • Nilai default: 128.
Id String 16f01ad6175e4230ac42bb5182cd****

ID template transkoding.

Container Object

Konfigurasi kontainer.

Format String mp4

Format kontainer.

Contoh

Permintaan Contoh

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=UpdateTemplate/?Action=UpdateTemplate
&ResourceOwnerId=1
&TemplateId=16f01ad6175e4230ac42bb5182cd****
&Name=MPS-example
&Container={"Format":"mp4"}
&Video={"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10"}
&Audio={"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}
&MuxConfig={"Segment":{"Duration":"10"}}
&TransConfig={"TransMode":"onepass"}
&<Common request parameters>

Respons Sukses Contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateTemplateResponse>
    <RequestId>5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21</RequestId>
    <Template>
        <Video>
            <LongShortMode>false</LongShortMode>
            <Bufsize>6000</Bufsize>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>500</Max>
                <Min>100</Min>
            </BitrateBnd>
            <PixFmt>yuv420p</PixFmt>
            <Pad>1280:800:0:140</Pad>
            <Codec>H.264</Codec>
            <Height>800</Height>
            <Qscale>1</Qscale>
            <Crop>border</Crop>
            <Bitrate>200</Bitrate>
            <Maxrate>500</Maxrate>
            <MaxFps>60</MaxFps>
            <Profile>high</Profile>
            <Crf>15</Crf>
            <Remove>false</Remove>
            <Gop>10</Gop>
            <Width>256</Width>
            <Fps>25</Fps>
            <Preset>medium</Preset>
            <ScanMode>interlaced</ScanMode>
            <ResoPriority>1</ResoPriority>
        </Video>
        <TransConfig>
            <IsCheckAudioBitrate>false</IsCheckAudioBitrate>
            <TransMode>onepass</TransMode>
            <IsCheckReso>false</IsCheckReso>
            <IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
            <AdjDarMethod>none</AdjDarMethod>
            <IsCheckVideoBitrate>false</IsCheckVideoBitrate>
            <IsCheckResoFail>false</IsCheckResoFail>
            <IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
        </TransConfig>
        <State>Normal</State>
        <MuxConfig>
            <Webp>
                <Loop>0</Loop>
            </Webp>
            <Gif>
                <FinalDelay>false</FinalDelay>
                <DitherMode>bayer</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>0</IsCustomPalette>
            </Gif>
            <Segment>
                <Duration>10</Duration>
            </Segment>
        </MuxConfig>
        <Name>MPS-example</Name>
        <Audio>
            <Profile>aac_low</Profile>
            <Remove>false</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>1</Qscale>
            <Channels>2</Channels>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </Template>
</UpdateTemplateResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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"
    },
    "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"
    },
    "Id" : "16f01ad6175e4230ac42bb5182cd****",
    "Container" : {
      "Format" : "mp4"
    }
  }
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.