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.
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.
|
| Bufsize | String | 6000 | Ukuran buffer.
|
| 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.
|
| Codec | String | H.264 | Kodek video. Nilai default: H.264. |
| Height | String | 800 | Tinggi video output.
|
| Qscale | String | 1 | Kekuatan algoritma noise reduction independen. |
| Crop | String | border | Metode yang digunakan untuk memotong video. Nilai yang valid:
|
| 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:
|
| Crf | String | 15 | Faktor kontrol kualitas bitrate.
|
| Remove | String | false | Menunjukkan apakah aliran video dihapus. Nilai yang valid:
|
| Gop | String | 10 | Jumlah maksimum frame antara dua keyframe. Nilai default: 250. |
| Width | String | 256 | Lebar video.
|
| Fps | String | 25 | Laju frame.
|
| Preset | String | medium | Algoritma video preset. Nilai default: medium. Nilai yang valid:
|
| ScanMode | String | interlaced | Mode pemindaian. Nilai yang valid:
|
| 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:
|
| TransMode | String | onepass | Mode transkoding. Nilai default: onepass. Nilai yang valid:
|
| 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.
|
| IsCheckVideoBitrateFail | String | false | Menunjukkan apakah bitrate video diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckVideoBitrate.
|
| AdjDarMethod | String | none | Metode penyesuaian resolusi. Nilai default: none. Nilai yang valid:
|
| 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:
|
| 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.
|
| IsCheckAudioBitrateFail | String | false | Menunjukkan apakah bitrate audio diperiksa. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckAudioBitrate.
|
| State | String | Normal | Status template. Nilai yang valid:
|
| 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:
|
| Remove | String | false | Menunjukkan apakah aliran audio dihapus. Nilai yang valid:
|
| Codec | String | aac | Kodek audio. Nilai default: aac. Nilai yang valid:
|
| Samplerate | String | 44100 | Laju pengambilan sampel.
|
| Qscale | String | 1 | Kekuatan algoritma noise reduction independen. |
| Channels | String | 2 | Jumlah saluran suara. Nilai default: 2. |
| Bitrate | String | 500 | Bitrate audio file output.
|
| 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.