Mengirimkan pekerjaan editing dan produksi media. Jika Anda perlu melakukan proses pasca-produksi seperti editing dan produksi pada materi video atau audio, Anda dapat memanggil operasi ini untuk mengotomatiskan proses tersebut.
Deskripsi operasi
Operasi ini hanya mengembalikan hasil pengiriman pekerjaan editing dan produksi media. Saat respons dikembalikan, pekerjaan tersebut mungkin masih dalam proses. Setelah dikirim, pekerjaan editing dan produksi media akan masuk ke antrian latar belakang untuk diproses secara asinkron.
Materi yang dirujuk dalam timeline proyek Pengeditan daring dapat berupa aset media di pustaka aset media atau objek Object Storage Service (OSS). URL eksternal atau URL Alibaba Cloud Content Delivery Network (CDN) tidak didukung. Untuk menggunakan objek OSS sebagai materi, Anda harus mengatur MediaUrl ke URL OSS, misalnya https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext.
Setelah produksi selesai, file output secara otomatis didaftarkan sebagai aset media. Aset media tersebut terlebih dahulu perlu dianalisis. Setelah analisis selesai, Anda dapat menanyakan informasi durasi dan resolusi berdasarkan ID aset media tersebut.
Batasan
-
Ambang batas pembatasan kecepatan operasi ini adalah 30 permintaan per detik (QPS).
**
Catatan Jika ambang batas dilampaui, kesalahan "Throttling.User" akan dikembalikan saat Anda mengirimkan pekerjaan editing. Untuk informasi lebih lanjut tentang cara mengatasi masalah ini, lihat FAQ.
-
Anda dapat membuat hingga 100 track video, 100 track gambar, dan 100 track subtitle dalam satu proyek.
-
Ukuran total file materi tidak boleh melebihi 1 TB.
-
Bucket OSS tempat materi berada dan tempat aset media output disimpan harus berada di wilayah yang sama dengan wilayah tempat Intelligent Media Services (IMS) diaktifkan.
-
Video output harus memenuhi persyaratan berikut:
Lebar dan tinggi masing-masing minimal 128 piksel.
Lebar dan tinggi masing-masing tidak boleh melebihi 4.096 piksel.
Sisi pendek video tidak boleh melebihi 2.160 piksel.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ice:SubmitMediaProducingJob |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| ProjectId |
string |
No |
ID dari editing project. Catatan
Anda harus menentukan salah satu dari ProjectId, Timeline, dan TemplateId, serta mengosongkan dua parameter lainnya. |
xxxxxfb2101cb318xxxxx |
| Timeline |
string |
No |
Timeline pekerjaan Pengeditan daring. Untuk informasi selengkapnya tentang parameter, lihat Konfigurasi Timeline. Catatan
: Anda harus menentukan salah satu dari ProgectId, Timeline, dan TempalteId serta mengosongkan dua parameter lainnya. |
{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"****4d7cf14dc7b83b0e801c****"},{"MediaId":"****4d7cf14dc7b83b0e801c****"}]}]} |
| TemplateId |
string |
No |
ID templat. Templat digunakan untuk membangun timeline dengan mudah. Catatan
Anda harus menentukan salah satu dari ProjectId, Timeline, atau TemplateId dan mengosongkan dua parameter lainnya. Jika TemplateId ditentukan, ClipsParam juga harus ditentukan. |
****96e8864746a0b6f3**** |
| ClipsParam |
string |
No |
Parameter materi templat dalam format JSON. Jika TemplateId ditentukan, ClipsParam juga harus ditentukan. Untuk informasi selengkapnya, lihat Buat dan gunakan templat reguler dan Buat dan gunakan templat advanced. |
见模板使用文档 |
| ProjectMetadata |
string |
No |
Metadata proyek editing dalam format JSON. Untuk informasi selengkapnya tentang parameter, lihat ProjectMetadata. |
{"Description":"剪辑视频描述","Title":"剪辑标题测试"} |
| OutputMediaTarget |
string |
No |
Jenis file output. Nilai yang valid:
|
oss-object |
| OutputMediaConfig |
string |
Yes |
Konfigurasi file output dalam format JSON. Anda dapat menentukan URL OSS atau lokasi penyimpanan di bucket penyimpanan ApsaraVideo VOD. Untuk menyimpan file output di OSS, Anda harus menentukan MediaURL. Untuk menyimpan file output di ApsaraVideo VOD, Anda harus menentukan StorageLocation dan FileName. Untuk informasi selengkapnya, lihat OutputMediaConfig. |
{"MediaURL":"https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4"} |
| UserData |
string |
No |
Data yang ditentukan pengguna dalam format JSON, dengan panjang maksimal 512 byte. Anda dapat menentukan URL callback kustom. Untuk informasi selengkapnya, lihat Konfigurasikan callback setelah editing selesai. |
{"NotifyAddress":"https://xx.com/xx","RegisterMediaNotifyAddress":"https://xxx.com/xx"} |
| ClientToken |
string |
No |
Token client yang digunakan untuk memastikan idempotensi permintaan. |
****12e8864746a0a398**** |
| Source |
string |
No |
Sumber permintaan editing dan produksi. Nilai yang valid:
|
OPENAPI |
| EditingProduceConfig |
string |
No |
Parameter untuk editing dan produksi. Untuk informasi selengkapnya, lihat EditingProduceConfig. Catatan
Jika tidak ada gambar mini yang ditentukan dalam EditingProduceConfig, frame pertama video akan digunakan sebagai gambar mini.
|
{ "AutoRegisterInputVodMedia": "true", "OutputWebmTransparentChannel": "true" } |
| MediaMetadata |
string |
No |
Metadata video yang dihasilkan dalam format JSON. Untuk informasi selengkapnya tentang parameter, lihat MediaMetadata. |
{ "Title":"test-title", "Tags":"test-tags1,tags2" } |
Contoh konfigurasi parameter OutputMediaConfig
Contoh: Simpan file output di OSS
{
"MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
"Bitrate": 2000,
"Width": 800,
"Height": 680
}
Untuk menyimpan file output di OSS, Anda harus menentukan MediaURL. Nilai default OutputMediaTarget adalah oss-object, yang menentukan penyimpanan file output di OSS. Parameter lain bersifat opsional. Bitrate menentukan bitrate file output. Secara umum, semakin tinggi bitrate, semakin jelas kualitas videonya. Nilai maksimum adalah 5.000. Width dan Height menentukan resolusi file output.
Tentukan URL OSS dalam format berikut: https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext.
bucketname: nama bucket OSS.
region-name.aliyuncs.com: Titik akhir publik OSS. Misalnya, titik akhir untuk wilayah Tiongkok (Shanghai), Tiongkok (Beijing), dan Tiongkok (Hangzhou) adalah:
oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com
oss-cn-beijing.aliyuncs.com
Contoh: Simpan file output di ApsaraVideo VOD
{
"StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",
"FileName": "output.mp4",
"Bitrate": 2000,
"Width": 800,
"Height": 680
}
Untuk menyimpan file output di ApsaraVideo VOD, Anda harus menentukan StorageLocation dan FileName. Atur OutputMediaTarget ke vod-media, yang menentukan penyimpanan file output di bucket penyimpanan ApsaraVideo VOD. Lokasi penyimpanan yang dapat digunakan di ApsaraVideo VOD dapat ditemukan di alamat penyimpanan aset media setelah aset media diunggah ke ApsaraVideo VOD.
Parameter dalam OutputMediaConfig
| Parameter | Tipe | Deskripsi |
| MediaURL | String | URL file output. Jika OutputMediaTarget diatur ke oss-object, tentukan URL HTTP objek OSS, seperti http://xxx-bucket-name.oss-cn-shanghai.aliyuncs.com/OSS. Wilayahnya sama dengan wilayah tempat operasi dipanggil. |
| StorageLocation | String | Jika OutputMediaTarget diatur ke vod-media, parameter ini menunjukkan lokasi penyimpanan aset media di ApsaraVideo VOD. Lokasi penyimpanan adalah path file di ApsaraVideo VOD, tanpa awalan http://. Contoh: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com. |
| FileName | String | Jika OutputMediaTarget diatur ke vod-media, parameter ini menunjukkan nama file output. Nilainya mencakup ekstensi nama file tetapi tidak mencakup path. |
| Width | Integer | Lebar file output. Anda dapat mengosongkan parameter ini. Nilai default adalah lebar maksimum materi input. |
| Height | Integer | Tinggi file output. Anda dapat mengosongkan parameter ini. Nilai default adalah tinggi maksimum materi input. |
| Bitrate | Integer | Bitrate file output. Satuan: Kbit/s. Anda dapat mengosongkan parameter ini. Nilai default adalah bitrate maksimum materi input. |
| VodTemplateGroupId | String | ID kelompok template transkoding VOD. Jika transkoding VOD tidak diperlukan, atur nilainya ke VOD_NO_TRANSCODE. |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter respons. |
||
| RequestId |
string |
ID permintaan. |
****36-3C1E-4417-BDB2-1E034F**** |
| ProjectId |
string |
ID proyek editing. |
****b4549d46c88681030f6e**** |
| JobId |
string |
ID pekerjaan. |
****d80e4e4044975745c14b**** |
| MediaId |
string |
ID aset media file output. |
****c469e944b5a856828dc2**** |
| VodMediaId |
string |
ID aset media file output di ApsaraVideo VOD jika file output disimpan di ApsaraVideo VOD. |
****d8s4h75ci975745c14b**** |
Contoh
Respons sukses
JSONformat
{
"RequestId": "****36-3C1E-4417-BDB2-1E034F****",
"ProjectId": "****b4549d46c88681030f6e****",
"JobId": "****d80e4e4044975745c14b****",
"MediaId": "****c469e944b5a856828dc2****",
"VodMediaId": "****d8s4h75ci975745c14b****"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter \ is not valid. | |
| 404 | ProjectNotFound | The specified project not found |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.