Intelligent Media Services:SubmitMediaProducingJob

• Penagihan: Editing klip video ditagih berdasarkan durasi video yang dihasilkan. Untuk detailnya, lihat Video clip. Tidak ada biaya yang dikenakan untuk pekerjaan yang gagal.

• Kemampuan editing beragam: Jika Anda perlu menyusun dan mendesain materi sesuai ide kreatif Anda, panggil operasi ini. Operasi ini mendukung konfigurasi Timeline yang fleksibel untuk memenuhi kebutuhan editing klip video yang kompleks.

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

• Eksekusi tugas asinkron: Operasi ini merupakan tugas asinkron. Setelah Anda mengirim tugas, ID tugas akan dikembalikan (tugas belum selesai dan masuk ke antrian latar belakang untuk dieksekusi secara asinkron). Hasil akhir dikirim melalui notifikasi callback. Anda juga dapat secara proaktif menanyakan status tugas dengan memanggil GetMediaProducingJob.

• Pertanyaan status tugas:

  1. Panggil GetMediaProducingJob dan masukkan JobId untuk menanyakan status dan hasil tugas.

  2. Saat mengirim pekerjaan produksi media, Anda dapat mengatur UserData dalam parameter permintaan untuk menyertakan URL callback. Saat tugas editing selesai atau gagal, sistem mengirim notifikasi ke URL callback tersebut. Anda dapat memproses data callback untuk memperoleh status tugas.

• Pendaftaran dan analisis aset media: Setelah komposit video selesai, aset media secara otomatis didaftarkan. Pada titik ini, aset media masih dalam status menganalisis. Setelah analisis selesai, Anda dapat memperoleh durasi dan resolusi video yang dihasilkan berdasarkan MediaId.

Batasan

• Batas throttling untuk operasi ini adalah 30 QPS (permintaan per detik untuk mengirim tugas). Tugas yang dikirim masuk ke antrian latar belakang dan diproses secara asinkron.

  Catatan

  Jika batas ini dilampaui, Anda mungkin mengalami error "Throttling.User". Untuk informasi lebih lanjut, lihat Error Throttling.User saat mengirim tugas editing.

• Jika Anda mengirim sejumlah besar tugas (misalnya 1.000 atau 10.000), sistem akan melakukan penskalaan dinamis, tetapi mungkin terjadi waktu antrean.

• Jumlah maksimum track untuk track video, track gambar, dan track subtitle masing-masing adalah 100.

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

• Wilayah bucket OSS input atau output harus sama dengan wilayah tempat IMS digunakan.

• Jika output berupa video, batasan resolusi berikut berlaku untuk video yang dihasilkan:

  • Lebar dan tinggi harus minimal 128 px.

  • Lebar dan tinggi tidak boleh melebihi 4.096 px.

  • Sisi pendek tidak boleh melebihi 2.160 px.

Contoh parameter OutputMediaConfig

Contoh: Output ke OSS

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

Saat mengoutput ke OSS, MediaURL wajib diisi. Nilai default parameter OutputMediaTarget adalah "oss-object", yang menunjukkan output ke OSS. Parameter lainnya bersifat opsional. Bitrate digunakan untuk mengatur bitrate media output. Umumnya, bitrate yang lebih tinggi menghasilkan video yang lebih jernih. Nilai maksimumnya adalah 5.000. Width dan Height digunakan untuk mengatur resolusi media output.

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

bucketname adalah nama bucket OSS.

oss-region-name.aliyuncs.com adalah titik akhir publik file OSS. Contohnya, titik akhir untuk Singapura, Jepang (Tokyo), dan AS (Virginia) adalah:

oss-ap-southeast-1.aliyuncs.com
oss-ap-northeast-1.aliyuncs.com 
oss-us-east-1.aliyuncs.com

Contoh: Output ke VOD

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

Saat mengoutput ke VOD, parameter StorageLocation dan FileName wajib diisi. Atur parameter OutputMediaTarget ke "vod-media" untuk mengoutput ke bucket penyimpanan VOD. Anda dapat melihat lokasi penyimpanan yang tersedia di VOD setelah mengunggah aset media dan memeriksa alamat penyimpanan aset media tersebut.

Pengaturan struktur OutputMediaConfig