All Products
Search

This Product

    ApsaraVideo Media Processing:Buat pekerjaan transkoding standar

    Document Center

    ApsaraVideo Media Processing:Buat pekerjaan transkoding standar

    Last Updated:Jun 21, 2026

    Anda dapat melakukan transkoding media dengan ApsaraVideo Media Processing (MPS) dengan mengirimkan pekerjaan transkoding melalui konsol atau dengan memanggil operasi API. Topik ini menjelaskan cara membuat pekerjaan transkoding standar di MPS.

    Sebelum memulai

    Lakukan persiapan berikut. Anda dapat melewati bagian ini jika sudah menyelesaikannya.

    • Aktifkan pipeline. Untuk pekerjaan transkoding standar, gunakan pipeline standar.

    • Unggah video yang akan diproses ke OSS.

      • Jika Anda ingin membuat pekerjaan, unggah langsung video ke OSS. Untuk informasi selengkapnya, lihat Unggah video.

      • Jika Anda ingin membuat alur kerja dan memicunya secara otomatis, Anda harus menambahkan bucket media dan membuat alur kerja sebelum mengunggah video. Setelah Anda menentukan bucket media input dan output serta mengunggah file media ke bucket input, MPS menerima notifikasi tentang pengunggahan tersebut dan memicu alur kerja terkait. Setelah alur kerja selesai, file media hasil pemrosesan diunggah ke bucket output. Untuk informasi selengkapnya, lihat Tambahkan bucket media.

    • Konfigurasikan template transkoding.

    • Gunakan template watermark untuk menyederhanakan penambahan watermark pada video Anda. Untuk informasi selengkapnya, lihat Template watermark.

    • Opsional. Aktifkan fitur notifikasi. Jika Anda ingin MPS mengirimkan notifikasi tentang pekerjaan dan alur kerja ke topik atau antrian MNS, konfigurasikan antrian atau topik MNS sesuai kebutuhan. Untuk informasi selengkapnya, lihat Siapkan notifikasi.

    Kirim pekerjaan melalui konsol

    Pekerjaan tunggal

    1. Masuk ke Konsol ApsaraVideo Media Processing.

    2. Di bilah navigasi atas, pilih wilayah. Misalnya, pilih China (Hangzhou).

    3. Di panel navigasi kiri, pilih Job Management.

    4. Di tab Encode, klik Create Task.

    5. Konfigurasikan parameter.

      Parameter

      Deskripsi

      Input File URL

      Klik Select. Di daftar drop-down Bucket, pilih bucket. Folder dalam bucket yang dipilih muncul di bawah Path. Pilih file input dari folder tersebut.

      Catatan

      • Jika tidak ada bucket yang tersedia di daftar drop-down, buka Konsol OSS untuk membuat bucket di wilayah saat ini. Untuk informasi selengkapnya, lihat Tambahkan bucket media.

      • Jika tidak ada file yang tersedia di bawah Path setelah memilih bucket, buka Konsol OSS dan unggah file ke bucket tersebut di wilayah saat ini.

      • Jika muncul prompt bahwa OSS belum diaktifkan, buka Konsol OSS untuk mengaktifkan layanan tersebut.

      • Jika muncul error peran atau pesan izin ditolak, buka Konsol Resource Access Management (RAM) dan berikan izin OSS yang diperlukan kepada Pengguna RAM saat ini. Anda dapat memberikan izin OSS penuh dengan menyambungkan kebijakan AliyunOSSFullAccess atau membuat kebijakan kustom sesuai kebutuhan. Untuk informasi selengkapnya, lihat Buat Pengguna RAM dan berikan izin.

      Encoding Pipeline

      Pilih pipeline dari daftar drop-down.

      Catatan

      • Jika tidak ada pipeline yang tersedia di daftar drop-down, aktifkan pipeline terlebih dahulu. Untuk informasi selengkapnya, lihat Buat pipeline.

      • Konkurensi pipeline transkoding tidak dijamin dan bergantung pada sumber daya yang tersedia. Konkurensi default adalah 200.

      Output File Name

      Masukkan nama untuk file output. Anda harus menambahkan ekstensi file untuk semua jenis file kecuali M3U8. Contohnya, masukkan example_video01.mp4.

      Output Path

      Klik Select. Di daftar drop-down Bucket, pilih bucket. Folder dalam bucket ditampilkan di bawah Path. Pilih folder sebagai jalur output.

      Catatan

      • Jika jalur output sama dengan jalur input tetapi nama file berbeda, file sumber tidak ditimpa. Jika nama file sama, konfigurasi OSS Anda yang menentukan apakah file sumber ditimpa. Untuk mencegah penimpaan file, lihat Cegah objek dengan nama yang sama agar tidak ditimpa (Java SDK V1). Jika Anda mengaktifkan pengaturan ini, pekerjaan gagal menulis file output ke OSS jika namanya sama dengan file sumber. Kami menyarankan Anda menggunakan nama berbeda untuk file output.

      • Untuk isu umum lainnya, lihat deskripsi untuk Input File URL.

    6. Klik Next.

    7. Konfigurasikan Encoding Template.

      Parameter

      Deskripsi

      Template Type

      Pilih jenis template transkoding. Untuk informasi tentang template preset, lihat Detail template preset. Untuk membuat template transkoding kustom, lihat Template transkoding.

      Output Format

      Pilih format output dari daftar drop-down. Nilai default-nya adalah mp4.

      Template

      Pilih template dari daftar. Nilai default-nya adalah MP4-4K.

      (Opsional) Watermark Template

      Aktifkan switch.

      1. Dari daftar drop-down Watermark Template, pilih template watermark yang telah Anda buat. Jika tidak ada template watermark dalam daftar, buat terlebih dahulu.

      2. Klik Select di samping Watermark Image. Di daftar drop-down Bucket, pilih bucket. Folder dalam bucket ditampilkan di bawah Path. Pilih file gambar dari folder tersebut.

        Catatan

        File watermark yang didukung mencakup gambar PNG, gambar PNG animasi, dan animasi MOV.

      (Opsional) Clip Output

      Aktifkan switch. Atur waktu mulai dan durasi untuk menentukan klip.

      1. Di bidang Start From, pilih waktu mulai dalam format HH:MM:SS.

        Catatan

        Waktu mulai harus kurang dari durasi total video. Jika tidak, pekerjaan transkoding gagal.

      2. Di bidang Clip Length, pilih durasi dalam format HH:MM:SS.

        Catatan

        Jika durasi klip yang ditentukan melebihi akhir video, klip akan berjalan hingga akhir video sumber.

      (Opsional) Rotate Angle

      Masukkan sudut rotasi searah jarum jam. Nilainya harus berada dalam rentang [0, 360].

    8. Klik Submit untuk membuat dan mengirimkan pekerjaan transkoding.

      Setelah pekerjaan dikirimkan, Anda dapat melihat status eksekusi, detail konfigurasi, jalur input, dan jalur output di daftar pekerjaan pada tab ini.

      Catatan

      Jika pekerjaan transkoding gagal dan Anda tidak dapat melihat detail kegagalannya, periksa koneksi jaringan Anda dan kirim ulang pekerjaan setelah koneksi stabil.

    Alur kerja

    1. Masuk ke Konsol ApsaraVideo Media Processing.

    2. Di bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi kiri, pilih Workflow > Workflow Orchestration.

    4. Klik Create Workflow.

    5. Konfigurasikan parameter alur kerja sesuai kebutuhan.

      1. Workflow Name: Masukkan nama untuk alur kerja.

      2. Configuration Plan: Pilih rencana konfigurasi dari daftar drop-down.

        Catatan

        ApsaraVideo Media Processing menyediakan alur kerja preset untuk kasus penggunaan umum. Anda dapat memilih dan mengedit alur kerja preset, atau membuat alur kerja kustom.

    6. Edit topologi alur kerja.

      1. Klik ikon plus (+) di samping node terkait dan pilih node Encode dari daftar drop-down.

      2. Klik ikon pensil di samping node Encode untuk membuka halaman Basic Settings.

      3. Konfigurasikan parameter transkoding.

        Parameter

        Deskripsi

        Name

        Masukkan nama untuk node ini.

        Encoding Template

        Klik Select. Di kotak dialog yang muncul, konfigurasikan Encoding Template.

        1. Pilih Template Type.

        2. Pilih Output Format.

        3. Pilih Template.

        4. Klik OK.

        Catatan

        Untuk informasi tentang template preset, lihat Detail template preset. Untuk membuat template kustom, lihat Template transkoding.

        Output Path

        Klik Select. Di daftar drop-down Bucket, pilih bucket. Folder dalam bucket ditampilkan di bawah Path. Pilih lokasi sebagai jalur output.

        Catatan

        • Jika jalur output sama dengan jalur input:

          • Jika nama file berbeda, file sumber tidak ditimpa.

          • Jika nama file sama, konfigurasi OSS Anda yang menentukan apakah file sumber ditimpa. Untuk mencegah penimpaan file, lihat Cegah objek dengan nama yang sama agar tidak ditimpa (Java SDK V1). Jika Anda mengaktifkan pengaturan ini, pekerjaan gagal menulis file output ke OSS jika namanya sama dengan file sumber. Kami menyarankan Anda menggunakan nama berbeda untuk file output.

        • Untuk mencegah file output ditimpa pada eksekusi alur kerja berikutnya, Anda dapat menggunakan kombinasi variabel bawaan berikut:

          • {RunId}: ID eksekusi alur kerja media.

          • {ObjectPrefix}: Jalur file sumber, tidak termasuk informasi bucket.

          • {FileName}: Nama file sumber, termasuk ekstensi. Ekstensi file output ditentukan oleh template transkoding yang dipilih.

          • {ExtName}: Ekstensi file sumber.

        (Opsional) Watermark

        Aktifkan switch.

        1. Pilih nama template dari daftar drop-down Watermark Template.

          Catatan

          Jika tidak ada template watermark dalam daftar drop-down, buat terlebih dahulu.

        2. Klik Select di samping Watermark Image untuk menambahkan jalur gambar watermark.

          Catatan

          File watermark yang didukung mencakup gambar PNG, gambar PNG animasi, dan animasi MOV.

        (Opsional) Encryption

        Aktifkan switch.

        Untuk Encryption Method, pilih Alibaba Cloud Private Encryption atau HLS Standard Encryption. Untuk informasi selengkapnya, lihat Enkripsi video.

        (Opsional) Clip

        Aktifkan switch.

        1. Untuk Clip Method, pilih Video Clip atau Video Ending Clip.

        2. Di bidang Start From, pilih waktu mulai.

        3. Di bidang Length, pilih durasi.

          Catatan

          • Waktu mulai harus kurang dari durasi total video. Jika tidak, pekerjaan transkoding gagal.

          • Jika durasi klip yang ditentukan melebihi akhir video, klip akan berjalan hingga akhir video sumber.

        (Opsional) Add Credits

        Aktifkan switch. Di samping File Path, klik Select dan pilih jalur file video credits.

        (Opsional) Rotate Angle

        Masukkan sudut rotasi searah jarum jam. Nilainya harus berada dalam rentang [0, 360].

      4. Klik OK untuk menyelesaikan konfigurasi node Encode.

    7. Klik Save untuk membuat alur kerja.

    Kirim pekerjaan melalui API

    Jika pembuatan pekerjaan atau alur kerja melalui konsol tidak memenuhi kebutuhan Anda, Anda dapat memanggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding secara terprogram dan mengonfigurasi parameter berdasarkan logika bisnis Anda.

    1. Panggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding.

      Untuk informasi selengkapnya, lihat Kirim pekerjaan transkoding. Selama proses pembuatan, Anda harus mengonfigurasi informasi transkoding sebagai berikut:

      1. PipelineId: Gunakan ID pipeline standar.

      2. TemplateId: Pilih template transkoding sesuai kebutuhan. Jika template preset tidak memenuhi kebutuhan Anda, Anda dapat membuat template kustom. Untuk informasi selengkapnya, lihat Tambahkan template transkoding kustom.

      3. (Opsional) Jika Anda memerlukan enkripsi, konfigurasikan parameter Encryption dalam objek Output.

        Catatan

        Output terenkripsi harus dalam format M3U8. API mendukung metode enkripsi Base64 dan KMS. Untuk informasi selengkapnya, lihat Detail parameter.

    2. Terima notifikasi callback.

      Saat pekerjaan transkoding selesai, jika Anda telah mengonfigurasi notifikasi event untuk pipeline, sebuah pesan dikirim ke antrian atau topik yang ditentukan di Simple Message Queue (formerly MNS). Untuk informasi selengkapnya, lihat Terima notifikasi.

    3. Kueri hasil pekerjaan.

      1. Panggil operasi Query transcoding jobs untuk mengkueri hasil pekerjaan dan mendapatkan URL file output.

      2. Panggil operasi List transcoding jobs untuk mengkueri beberapa pekerjaan transkoding berdasarkan ID pipeline, status pekerjaan, dan rentang waktu pembuatan.