All Products
Search
Document Center

Intelligent Media Services:SubmitMediaProducingJob

Last Updated:Mar 21, 2026

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

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

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: objek OSS di bucket OSS.

  • vod-media: aset media di ApsaraVideo VOD.

  • S3: file output berdasarkan protokol Amazon Simple Storage Service (S3).

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

  • AliyunConsole

  • WebSDK

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: menentukan apakah aset media ApsaraVideo VOD dalam timeline Anda akan didaftarkan secara otomatis ke IMS. Nilai default: true.

  • OutputWebmTransparentChannel: menentukan apakah video output berisi saluran alfa. Nilai default: false.

  • CoverConfig: parameter gambar mini kustom.

{ "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

ParameterTipeDeskripsi
MediaURLStringURL 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.
StorageLocationStringJika 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.
FileNameStringJika OutputMediaTarget diatur ke vod-media, parameter ini menunjukkan nama file output. Nilainya mencakup ekstensi nama file tetapi tidak mencakup path.
WidthIntegerLebar file output. Anda dapat mengosongkan parameter ini. Nilai default adalah lebar maksimum materi input.
HeightIntegerTinggi file output. Anda dapat mengosongkan parameter ini. Nilai default adalah tinggi maksimum materi input.
BitrateIntegerBitrate file output. Satuan: Kbit/s. Anda dapat mengosongkan parameter ini. Nilai default adalah bitrate maksimum materi input.
VodTemplateGroupIdStringID 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.