Memproduksi satu atau beberapa video menjadi video akhir. Anda dapat mengirimkan video sumber secara langsung melalui parameter timeline, atau membuat proyek pengeditan daring terlebih dahulu lalu mengirimkannya untuk produksi.
Deskripsi operasi
-
Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Pengeditan daring adalah fitur berbayar. Untuk informasi lebih lanjut tentang penagihan, lihat Penagihan pengeditan dan produksi video.
-
Ini adalah operasi asinkron. Setelah Anda mengirimkan tugas, ID proyek pengeditan daring dikembalikan (video belum diproduksi, dan tugas masuk ke antrian untuk eksekusi asinkron). Hasil akhir dikirim melalui notifikasi callback. Anda juga dapat memanggil GetEditingProject untuk mengkueri status tugas.
-
Resource video yang digunakan dalam timeline pengeditan daring dapat berupa materi di pustaka materi atau video di pustaka media. Jika Anda menggunakan video dari pustaka media, pastikan statusnya Normal.
-
Video diproduksi berdasarkan ProjectId dan Timeline. Logikanya adalah sebagai berikut:
ProjectId dan Timeline tidak boleh kosong keduanya. Jika tidak, tidak ada dasar untuk memproduksi video.
Jika ProjectId kosong dan Timeline tidak kosong, proyek pengeditan daring dibuat secara otomatis dengan Timeline yang ditentukan. Materi yang direferensikan dalam Timeline diekstrak dan ditetapkan sebagai materi proyek. Kemudian, produksi video dimulai.
Jika ProjectId tidak kosong dan Timeline kosong, Timeline yang terakhir disimpan diambil berdasarkan ProjectId dan digunakan untuk memproduksi video.
Jika ProjectId dan Timeline tidak kosong keduanya, Timeline yang ditentukan digunakan untuk memproduksi video, dan proyek pengeditan daring yang sesuai diperbarui (Timeline dan materi proyek). Jika bidang lain ditentukan, bidang proyek yang sesuai juga diperbarui.
-
Jumlah maksimum trek untuk trek video, trek gambar, dan trek subtitle masing-masing adalah 100.
-
Jumlah total materi tidak boleh melebihi 200, dan ukuran file total materi tidak boleh melebihi 1 TB.
-
Wilayah bucket input atau output harus sama dengan wilayah tempat layanan ApsaraVideo VOD digunakan.
-
Ketika output adalah video, batas resolusi berikut berlaku untuk video akhir:
Lebar dan tinggi masing-masing harus minimal 128 px.
Lebar dan tinggi masing-masing harus maksimal 4096 px.
Sisi pendek harus maksimal 2160 px.
-
Setelah produksi video selesai, video secara otomatis diunggah ke ApsaraVideo VOD. Oleh karena itu, setelah produksi video selesai, ApsaraVideo VOD mengirimkan notifikasi event ProduceMediaComplete dan FileUploadComplete. Setelah transkoding video yang diproduksi selesai, notifikasi event transkoding video definisi tunggal selesai dan transkoding video semua definisi selesai dikirim.
-
Anda juga dapat menambahkan efek ke video yang diproduksi. Untuk detail lebih lanjut, lihat Efek.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vod:ProduceEditingProjectVideo |
create |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| ProjectId |
string |
No |
ID proyek pengeditan daring. Anda dapat memperoleh ID dengan menggunakan salah satu metode berikut:
|
fb2101bf24b4cb318787dc**** |
| Timeline |
string |
No |
Timeline proyek pengeditan daring dalam format JSON. Untuk informasi lebih lanjut tentang struktur, lihat Timeline. Catatan
Pastikan setiap objek VideoTrackClip berisi MediaId yang valid. Jika tidak, permintaan akan gagal. |
{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]} |
| Title |
string |
No |
Judul proyek pengeditan daring. |
Judul Proyek Cloud Clip. |
| Description |
string |
No |
Deskripsi proyek pengeditan daring. |
Deskripsi proyek cloud clip. |
| CoverURL |
string |
No |
Gambar mini proyek pengeditan daring. |
https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png. |
| MediaMetadata |
string |
No |
Metadata video yang diproduksi dalam format JSON. Untuk informasi lebih lanjut tentang struktur, lihat MediaMetadata. |
{"Description":"Deskripsi Video Sintetis","Title":"Uji userData Sintetis"} |
| ProduceConfig |
string |
No |
Konfigurasi produksi dalam format JSON. Untuk informasi lebih lanjut tentang struktur, lihat ProduceConfig. Penting
Bidang StorageLocation dapat diabaikan ketika wilayah penyimpanan file adalah Shanghai. Bidang ini diperlukan ketika wilayah penyimpanan file berada di wilayah lain.
|
{"TemplateGroupId":"6d11e25ea30a4c465435c74****"} |
| UserData |
string |
No |
Pengaturan kustom dalam format JSON. Panjang maksimum adalah 256 karakter. Pengaturan mendukung callback paket dan konfigurasi lainnya. Untuk informasi lebih lanjut tentang struktur, lihat UserData. Catatan
Untuk menggunakan callback paket dalam parameter ini, konfigurasikan URL callback HTTP dan pilih tipe event callback yang sesuai di konsol. Jika tidak, pengaturan callback tidak akan berlaku. |
{"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}} |
| AppId |
string |
No |
ID aplikasi. Nilai default: app-1000000. Untuk informasi lebih lanjut, lihat Multi-aplikasi. |
app-**** |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter tanggapan. |
||
| RequestId |
string |
ID permintaan. |
25818875-5F78-4AF6-D7393642CA58**** |
| MediaId |
string |
ID video yang diproduksi. Catatan
|
006204a11bb386bb25491f95f**** |
| ProjectId |
string |
ID proyek pengeditan daring. |
fb2101bf24b4cb318787dc**** |
Contoh
Respons sukses
JSONformat
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"MediaId": "006204a11bb386bb25491f95f****",
"ProjectId": "fb2101bf24b4cb318787dc****"
}Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.