All Products
Search

This Product

    Intelligent Media Management:CreateMediaConvertTask

    Document Center

    Intelligent Media Management:CreateMediaConvertTask

    Last Updated:Jun 12, 2026

    Membuat tugas transkoding media asinkron. Menyediakan kemampuan untuk transkoding media, penggabungan media, pengambilan frame video, konversi video ke gambar animasi, dan pemrosesan file media audio/video lainnya.

    Deskripsi operasi

    • Sebelum menggunakan operasi API ini, pastikan Anda sepenuhnya memahami metode penagihan dan harga produk Intelligent Media Management (IMM).

    • Sebelum memanggil operasi API ini, pastikan proyek tersedia di wilayah saat ini. Untuk informasi selengkapnya, lihat Manajemen proyek.
      Penting Tugas asinkron tidak menjamin ketepatan waktu.

    • Saat Anda menggunakan operasi API ini untuk transkoding media, hanya satu aliran video, audio, atau subtitle yang diproses secara default. Anda juga dapat mengonfigurasi jumlah aliran video, audio, atau subtitle yang akan diproses.

    • Saat Anda menggunakan operasi API ini untuk penggabungan media, maksimum 11 file media didukung. Parameter transkoding, pengambilan frame, dan lainnya yang dikonfigurasi diterapkan pada data media yang digabungkan.

    • Ini adalah operasi API asinkron. Setelah tugas dimulai, informasi tugas hanya disimpan selama 7 hari. Setelah 7 hari, informasi tugas tidak dapat lagi diperoleh. Panggil operasi GetTask atau ListTasks untuk mendapatkan TaskId yang dikembalikan dan melihat informasi tugas. Anda juga dapat mengonfigurasi parameter Notifikasi Paket Notification untuk mendapatkan informasi tugas melalui Notifikasi Paket.

    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

    imm:CreateMediaConvertTask

    create

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ProjectName

    string

    Yes

    Nama proyek. Untuk informasi tentang cara mendapatkan nama proyek, lihat Membuat proyek.

    test-project
    Sources

    array<object>

    Yes

    Daftar file media. Jika daftar berisi lebih dari satu elemen, fitur Concat (penggabungan) diaktifkan. Urutan penggabungan mengikuti urutan URI file video input.

    array<object>

    No

    File media sumber.

    URI

    string

    No

    Alamat OSS mengikuti aturan oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan ${Object} adalah jalur file lengkap termasuk ekstensi file.

    oss://test-bucket/test-object
    StartTime

    number

    No

    Waktu mulai untuk transkoding media, dalam detik. Nilai valid:

    • 0 (default): Transkoding dimulai dari awal media.

    • n (lebih besar dari 0): Transkoding dimulai n detik setelah awal media.

    0
    Duration

    number

    No

    Durasi transkoding media, dalam detik. Nilai default: 0, yang menunjukkan bahwa transkoding berlanjut hingga akhir video.

    0
    Subtitles

    array<object>

    No

    Daftar subtitle yang akan ditambahkan. Nilai default: kosong.

    object

    No

    Informasi subtitle.

    URI

    string

    No

    Alamat OSS mengikuti aturan oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan ${Object} adalah jalur file lengkap termasuk ekstensi file. Format subtitle yang didukung: srt, vtt, mov_text, ass, dvd_sub, pgs.

    oss://test-bucket/test-object

    TimeOffset

    number

    No

    pengatur waktu penundaan subtitle, dalam detik. Nilai default: 0.

    10.5
    Language

    string

    No

    Bahasa subtitle. Standar referensi adalah ISO 639-2. Nilai default: kosong.

    eng
    Attached

    boolean

    No

    Apakah akan menambahkan file media sumber saat ini sebagai aliran audio atau aliran video yang disinkronkan ke file media output. Nilai default: false.

    Catatan

    • Parameter Attached dari Source yang ditunjuk oleh parameter AlignmentIndex tidak dapat diatur ke true.

    false
    AlignMode

    string

    No

    Strategi penyelarasan untuk menambahkan aliran audio dan aliran video. Nilai valid:

    • false (default): Tidak ada penyelarasan.

    • loop: Melakukan loop pada konten audio dan aliran video untuk penyelarasan.

    • pad: Menyelaraskan dengan menambahkan padding berupa frame audio senyap dan frame video hitam.

    Catatan

    • Parameter ini hanya berlaku ketika parameter Attached diatur ke true.

    false
    DisableVideo

    boolean

    No

    Apakah akan menonaktifkan video di file media sumber. Nilai valid:

    • true: Dinonaktifkan.

    • false (default): Tidak dinonaktifkan.

    false
    DisableAudio

    boolean

    No

    Apakah akan menonaktifkan audio di file media sumber. Nilai valid:

    • true: Dinonaktifkan.

    • false (default): Tidak dinonaktifkan.

    false
    Targets

    array<object>

    No

    Daftar tugas pemrosesan media. Beberapa tugas dapat dikonfigurasi.

    array<object>

    No

    Detail elemen array Targets.

    URI

    string

    No

    Alamat OSS file output transkoding media.

    Alamat OSS mengikuti aturan oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan ${Object} adalah jalur file lengkap termasuk ekstensi file.

    • Saat URI memiliki ekstensi file, alamat OSS file media output yang ditranskode adalah URI. Jika beberapa file output dihasilkan, file tersebut dapat saling menimpa.

    • Saat URI tidak memiliki ekstensi file, alamat OSS file media output yang ditranskode ditentukan oleh parameter URI, Container, dan Segment. Misalnya, jika URI adalah oss://examplebucket/outputVideo:

      • Saat Container adalah mp4 dan Segment kosong, alamat OSS file media yang dihasilkan adalah oss://examplebucket/outputVideo.mp4.

      • Saat Container adalah ts dan format di Segment adalah hls, file m3u8 dengan alamat OSS oss://examplebucket/outputVideo.m3u8 dan beberapa file ts dengan awalan oss://examplebucket/outputVideo akan dihasilkan.

    oss://test-bucket/test-target-object.mp4
    Container

    string

    No

    Tipe kontainer media. Tipe kontainer yang valid:

    • Kontainer audio dan video: mp4, mkv, mov, asf, avi, mxf, ts, flv

    • Kontainer audio: mp3, aac, flac, oga, ac3, opus
      Penting Parameter Container dan URI harus diatur bersama. Jika hanya ekstraksi subtitle, pengambilan frame, pengambilan gambar sprite, atau konversi video ke gambar animasi yang diperlukan, atur kedua parameter Container dan URI ke nilai kosong. Dalam hal ini, parameter Segment, Video, Audio, Speed, dan lainnya tidak memiliki arti.
      .

    mp4
    Speed

    number

    No

    Pengaturan kecepatan pemutaran media. Nilai valid: [0.5, 1.0]. Nilai default: 1.0.

    Catatan

    Rasio kecepatan pemutaran default file media yang ditranskode terhadap file media sumber. Ini bukan transkoding berbasis kecepatan.

    1.0
    Segment

    object

    No

    Pengaturan segmentasi media. Segmentasi tidak dilakukan secara default.

    Format

    string

    No

    Format segmentasi media. Nilai valid:

    • hls

    • dash.

    hls
    Duration

    number

    No

    Durasi segmen, dalam detik.

    30
    StartNumber

    integer

    No

    Nomor urut awal. Hanya HLS yang didukung. Nilai default: 0.

    5
    Video TargetVideo

    No

    Pengaturan parameter pemrosesan video.

    Penting Saat Video diatur ke nilai kosong, aliran video pertama (jika ada) langsung disalin ke file output.

    Audio TargetAudio

    No

    Pengaturan parameter pemrosesan audio.

    Penting Saat Audio diatur ke nilai kosong, aliran audio pertama (jika ada) langsung disalin ke file output.

    Subtitle TargetSubtitle

    No

    Pengaturan parameter pemrosesan subtitle.

    Penting Saat Subtitle diatur ke nilai kosong, aliran subtitle pertama (jika ada) langsung disalin ke file output.

    Image TargetImage

    No

    Pengaturan parameter untuk pengambilan frame, pengambilan gambar sprite, dan konversi video ke gambar animasi.

    StripMetadata

    boolean

    No

    Apakah akan menghapus metadata dari file media, seperti title dan album. Nilai default: false.

    Data

    object

    No

    Konfigurasi retensi aliran data. Aliran data tidak dipertahankan secara default.

    Penting Retensi aliran data hanya didukung saat Container diatur ke mp4.
    .

    Stream

    array

    No

    Daftar nomor indeks aliran data yang akan diproses dari file sumber. Nilai kosong (default) menunjukkan bahwa tidak ada aliran data yang dipertahankan. Nomor indeks -1 menunjukkan bahwa semua aliran data dipertahankan.

    • Contoh: [0,1] memproses aliran data dengan nomor indeks 0 dan 1; [1] memproses aliran data dengan nomor indeks 1; [-1] memproses semua aliran data.

    Catatan

    Hanya aliran data dengan nomor indeks yang ada yang diproses. Jika aliran data yang sesuai dengan nomor indeks tidak ada, nomor indeks tersebut diabaikan.

    integer

    No

    Nomor indeks aliran data yang akan diproses.

    0
    AttachedPicture

    object

    No

    Konfigurasi retensi gambar sampul. Gambar sampul tidak dipertahankan secara default.

    Penting Retensi gambar sampul hanya didukung saat Container diatur ke mp4 atau mkv.
    .

    Stream

    array

    No

    Daftar nomor indeks gambar sampul yang akan diproses dari file sumber. Nilai kosong (default) menunjukkan bahwa tidak ada gambar sampul yang dipertahankan. Nomor indeks -1 menunjukkan bahwa semua gambar sampul dipertahankan.

    • Contoh: [0,1] memproses gambar sampul dengan nomor indeks 0 dan 1; [1] memproses gambar sampul dengan nomor indeks 1; [-1] memproses semua gambar sampul.

    Catatan

    Hanya gambar sampul dengan nomor indeks yang ada yang diproses. Jika gambar sampul yang sesuai dengan nomor indeks tidak ada, nomor indeks tersebut diabaikan.

    integer

    No

    Nomor indeks gambar sampul yang akan diproses.

    0
    UserData

    string

    No

    Informasi pengguna kustom. Informasi ini dikembalikan dalam Notifikasi Paket asinkron untuk memfasilitasi pemrosesan asosiatif Notifikasi Paket di sistem Anda. Panjang maksimum: 2048 byte.

    {"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
    Tags

    object

    No

    Tag kustom yang digunakan untuk mencari dan memfilter tugas asinkron.

    {"test":"val1"}
    CredentialConfig CredentialConfig

    No

    Jika Anda tidak memiliki persyaratan khusus, biarkan parameter ini kosong.

    Konfigurasi otorisasi berantai. Untuk informasi selengkapnya, lihat Menggunakan otorisasi berantai untuk mengakses resource entitas lain.

    Notification Notification

    No

    Konfigurasi Notifikasi Paket. Untuk detail, klik Notification. Untuk format Notifikasi asinkron, lihat format Notifikasi asinkron.

    AlignmentIndex

    integer

    No

    Nomor urut file media utama (yang menyediakan parameter Transkoding default di Video dan Audio, termasuk resolusi dan laju frame) dalam daftar penggabungan selama penggabungan media. Nilai default: 0 (diselaraskan dengan file media pertama dalam daftar penggabungan).

    0
    TargetGroups

    array<object>

    No

    Daftar tugas pengemasan media. File media input dikonversi dan dikemas sebagai output HLS. Setiap TargetGroup sesuai dengan HLS Master Playlist. Beberapa tugas dapat dikonfigurasi.

    array<object>

    No

    URI

    string

    No

    Alamat OSS file HLS Master Playlist yang dihasilkan oleh tugas pengemasan.

    oss://test-bucket/test-object/master.m3u8
    Targets

    array<object>

    No

    Daftar subtugas pengemasan media. Setiap Target sesuai dengan aliran varian (#EXT-X-STREAM-INF) di HLS Master Playlist dan menghasilkan HLS Media Playlist yang sesuai.

    array<object>

    No

    URI

    string

    No

    Alamat OSS file HLS Media Playlist yang dihasilkan oleh subtugas pengemasan.

    Penting URI ini harus berada di direktori yang sama atau subdirektori dari TargetGroups.URI.
    .

    oss://test-bucket/test-target-object.mp4
    Container

    string

    No

    Tipe kontainer pengemasan. Hanya mp4 dan ts yang didukung.

    mp4
    Speed

    number

    No

    Pengaturan kecepatan pemutaran media. Nilai valid: [0.5, 1.0]. Nilai default: 1.0.

    Catatan

    Rasio kecepatan pemutaran default file media yang ditranskode terhadap file media sumber. Ini bukan transkoding berbasis kecepatan.

    1.0
    Segment

    object

    No

    Konfigurasi pengemasan media.

    Format

    string

    No

    hls
    Duration

    number

    No

    30
    StartNumber

    integer

    No

    5
    Video TargetVideo

    No

    Pengaturan parameter pemrosesan video.

    Penting Saat Video diatur ke nilai kosong, aliran video pertama (jika ada) langsung disalin ke file output.

    Audio TargetAudio

    No

    Pengaturan parameter pemrosesan audio.

    Penting Saat Audio diatur ke nilai kosong, aliran audio pertama (jika ada) langsung disalin ke file output.

    Subtitle TargetSubtitle

    No

    Pengaturan parameter pemrosesan subtitle.

    Penting Anda harus menggunakan parameter Subtitle.ExtractSubtitle untuk mengemas aliran subtitle. Subtitle.ExtractSubtitle.URI harus berada di direktori yang sama atau subdirektori dari TargetGroups.URI. Subtitle.ExtractSubtitle.Format harus diatur ke vtt. Anda hanya perlu mengonfigurasi ini di satu Target untuk mengemas semua aliran subtitle.
    .

    StripMetadata

    boolean

    No

    Apakah akan menghapus metadata. Nilai default: false.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Struktur tanggapan.

    RequestId

    string

    ID permintaan.

    CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
    EventId

    string

    ID event.

    0ED-1Bz8z71k5TtsUejT4UJ16Es****
    TaskId

    string

    ID tugas.

    MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "TaskId": "MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.