Intelligent Media Services:SubmitMediaProducingJob

• Deskripsi penagihan: Pengeditan video ditagih berdasarkan durasi keluaran yang diproduksi. Untuk detail, lihat Pengeditan video. Jika pemrosesan gagal, tidak ada biaya yang dikenakan.

• Kemampuan pengeditan yang beragam: Ketika Anda perlu mengatur dan mendesain materi sesuai kreativitas yang dipersonalisasi, Anda perlu memanggil API ini. API ini mendukung Konfigurasi Timeline yang fleksibel untuk menerapkan persyaratan pengeditan video yang kompleks.

• Aturan referensi materi: Materi yang direferensikan dalam timeline pengeditan cloud dapat berupa aset media di pustaka materi atau file OSS yang direferensikan secara langsung. URL eksternal atau URL CDN tidak didukung. Ketika materi berupa file OSS, MediaUrl hanya mendukung format URL OSS, seperti: https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext.

• Eksekusi tugas asinkron: API ini merupakan tugas asinkron. Setelah mengirimkan pekerjaan, ID tugas akan dikembalikan (pada titik ini tugas belum selesai dan akan dimasukkan ke antrean di latar belakang untuk eksekusi asinkron). Hasil akhir akan diberi tahu melalui callback, dan Anda juga dapat secara aktif mengkueri status tugas dengan memanggil Query editing and producing job.

• Kueri status tugas:

  1. Panggil Query editing and producing job dan masukkan JobId untuk mengkueri status dan hasil tugas.

  2. Saat mengirimkan pekerjaan pengeditan dan produksi, Anda dapat mengatur UserData di parameter permintaan untuk menyertakan URL callback. Ketika pekerjaan pengeditan selesai atau gagal, sistem akan mengirimkan notifikasi ke URL callback, dan Anda dapat memahami status tugas dengan memproses data callback.

• Registrasi dan analisis aset media: Setelah produksi video selesai, aset media akan didaftarkan secara otomatis. Pada titik ini, aset media masih dalam status analisis. Setelah analisis aset media selesai, Anda dapat memperoleh informasi durasi dan resolusi video yang diproduksi berdasarkan MediaId.

Batas penggunaan

• Nilai pembatasan kecepatan API ini adalah 30 QPS (jumlah permintaan pengiriman pekerjaan per detik). Pekerjaan yang dikirimkan akan dimasukkan ke antrean di latar belakang dan diproses secara asinkron.

  Catatan

  Jika batas ini terlampaui, Anda mungkin mengalami error "Throttling.User". Untuk detail, lihat: Mengalami error "Throttling.User" saat mengirimkan pekerjaan pengeditan.

• Saat mengirimkan sejumlah besar pekerjaan (misalnya 1.000 atau 10.000), sistem akan melakukan penskalaan dinamis, tetapi mungkin ada pengatur waktu antrean.

• Jumlah trek video, trek gambar, dan trek subtitle dibatasi maksimal 100 untuk masing-masing.

• Tidak ada batasan pada jumlah materi, dan total ukuran file materi tidak boleh melebihi 1 TB.

• Wilayah Bucket OSS input atau output harus konsisten dengan Wilayah tempat IMS digunakan.

• Ketika keluaran berupa video, resolusi video yang diproduksi memiliki batas berikut:

  • Lebar maupun tinggi tidak boleh kurang dari 128 px.

  • Lebar maupun tinggi tidak boleh lebih dari 4096 px.

  • Sisi pendek tidak boleh lebih dari 2160 px.

Contoh parameter OutputMediaConfig

Contoh: Keluaran ke OSS

{
  "MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Saat mengeluarkan ke OSS, MediaURL diperlukan. Nilai default parameter OutputMediaTarget adalah "oss-object", yang berarti mengeluarkan ke OSS. Parameter lainnya bersifat opsional, di mana Bitrate digunakan untuk mengatur bitrate produk keluaran. Umumnya, bitrate yang lebih tinggi berarti kualitas yang lebih jelas, dan maksimum dapat diatur ke 5000. Width dan Height digunakan untuk mengatur resolusi keluaran yang diproduksi.

Format jalur URL OSS: https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname adalah nama Bucket OSS.

oss-region-name.aliyuncs.com adalah Endpoint eksternal file OSS. Misalnya, endpoint untuk Shanghai, Beijing, dan Hangzhou adalah:

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

Contoh: Keluaran ke VOD

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Saat mengeluarkan ke VOD, parameter StorageLocation dan FileName diperlukan. Parameter OutputMediaTarget diatur ke "vod-media", yang berarti mengeluarkan ke Bucket penyimpanan VOD. Lokasi penyimpanan yang tersedia untuk VOD dapat dilihat di alamat penyimpanan aset media setelah mengunggah aset media di VOD.

Deskripsi parameter dalam struktur OutputMediaConfig