All Products
Search
Document Center

Intelligent Media Services:SubmitIProductionJob

Last Updated:Apr 07, 2026

Gunakan operasi SubmitIProductionJob untuk mengirimkan pekerjaan produksi cerdas.

Deskripsi operasi

Ini adalah API asinkron. Saat Anda mengirimkan tugas, API akan mengembalikan ID tugas dan mengantri tugas tersebut untuk diproses secara asinkron. Hasil akhir dikirimkan melalui callback. Anda juga dapat mengecek status tugas dengan memanggil QuerySmartProductionTask.

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:SubmitIProductionJob

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

No

Nama pekerjaan, yang panjangnya maksimal 100 karakter.

测试任务

FunctionName

string

Yes

Nama fungsi algoritma. Nilai yang valid:

  • Cover: Menghasilkan sampul cerdas.

  • VideoClip: Membuat ringkasan video.

  • VideoDelogo: Menghapus logo dari video.

  • VideoDetext: Menghapus teks dari video.

  • CaptionExtraction: Mengekstraksi keterangan dari video.

  • VideoGreenScreenMatting: Melakukan keying layar hijau untuk video.

  • FaceBeauty: Menerapkan filter kecantikan pada wajah dalam video.

  • VideoH2V: Mengonversi video horizontal menjadi video vertikal.

  • MusicSegmentDetect: Mendeteksi segmen chorus dalam musik.

  • AudioBeatDetection: Mendeteksi ketukan dalam trek audio.

  • AudioQualityAssessment: Menilai kualitas audio.

  • SpeechDenoise: Mengurangi kebisingan dalam audio ucapan.

  • AudioMixing: Mencampur trek audio.

  • MusicDemix: Memisahkan vokal dari iringan dalam musik.

Cover

Input

object

Yes

Aset media input. Anda dapat menentukan file OSS atau ID aset media.

Persyaratan untuk file input bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan.

Type

string

Yes

Jenis media input. Nilai yang valid:

  • OSS: Jalur file OSS.

  • Media: ID aset media.

OSS

Media

string

Yes

URL OSS dari file input atau ID aset media input. URL OSS dapat dalam salah satu format berikut:

  1. oss://<bucket>/<object>

  2. http(s)://<bucket>.oss-<regionId>.aliyuncs.com/<object> Dalam format ini, <bucket> adalah nama bucket OSS di wilayah yang sama dengan proyek Anda, dan <object> adalah jalur file.

oss://bucket/object

Output

object

Yes

Tujuan output. Anda dapat menentukan jalur file OSS atau ID aset media.

File output bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan.

Type

string

Yes

Jenis media output. Nilai yang valid:

  • OSS: Jalur file OSS.

  • Media: ID aset media.

OSS

Biz

string

No

Layanan tempat aset media tersebut berada.

IMS

Media

string

Yes

Tujuan output. Jika Type bernilai OSS, tentukan URL OSS. Jika Type bernilai Media, tentukan ID aset media.

URL OSS dapat dalam salah satu format berikut:

  1. oss://<bucket>/<object>

  2. http(s)://<bucket>.oss-<regionId>.aliyuncs.com/<object> Dalam format ini, <bucket> adalah nama bucket OSS di wilayah yang sama dengan proyek Anda, dan <object> adalah jalur file.

ID aset media:

  • Untuk menggunakan aset media yang sudah ada, tentukan ID-nya.

    • Parameter Biz tidak diperlukan; layanan dari aset sumber akan digunakan.

  • Untuk membuat aset media baru, biarkan bidang ini kosong.

    • Parameter Biz menentukan apakah aset dibuat di IMS atau VOD. Jika Biz tidak ditentukan, sistem akan menggunakan layanan dari aset sumber. Jika sumber bukan aset media, output secara default akan masuk ke IMS.

Catatan

Jalur file OSS mendukung placeholder. Contoh: oss://example-****/iproduction/{source}-{timestamp}-{sequenceId}.png. Placeholder berikut didukung:

  • {source}: Nama file input.

  • {timestamp}: Unix timestamp.

  • {sequenceId}: ID urutan yang dihasilkan sistem.

  • {resultType}: Jenis file output, yang ditentukan oleh server. Placeholder bersifat opsional. Namun, untuk algoritma yang menghasilkan beberapa output, seperti Cover, kami merekomendasikan menyertakan placeholder seperti {sequenceId} untuk memastikan jalur file unik dan mencegah penimpaan file yang sudah ada.

oss://bucket/object

OutputUrl

string

No

Jika Type diatur ke Media, Anda dapat menggunakan parameter ini untuk menentukan URL OSS untuk file output. Bucket harus terdaftar di IMS atau VOD.

http(s)://bucket.oss-[RegionId].aliyuncs.com/object

TemplateId

string

No

ID templat.

****20b48fb04483915d4f2cd8ac****

JobParams

string

No

Parameter pekerjaan algoritma, ditentukan sebagai string berformat JSON. Konten objek JSON bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan.

{"Model":"gif"}

ScheduleConfig

object

No

Konfigurasi penjadwalan pekerjaan.

PipelineId

string

No

ID pipeline.

5246b8d12a62433ab77845074039c3dc

Priority

integer

No

Prioritas pekerjaan, yang dapat berupa bilangan bulat dari 1 hingga 10. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

6

UserData

string

No

Data pengguna kustom. Sistem meneruskan data ini dan mengembalikannya apa adanya dalam callback atau respons. Panjangnya tidak boleh melebihi 256 karakter.

{"test":1}

ModelId

string

No

ID model algoritma. Jika Anda tidak menentukan parameter ini, sistem akan menggunakan model default untuk fungsi yang dipilih. Kami merekomendasikan untuk membiarkan parameter ini kosong kecuali Anda perlu menggunakan model alternatif tertentu.

Fungsi berikut menawarkan model alternatif:

  • VideoDetext
    • Atur ModelId ke algo-video-detext-new untuk menggunakan algoritma penghapusan subtitle tingkat lanjut. Model ini memberikan hasil berkualitas lebih tinggi tetapi lebih lambat dan lebih mahal dibandingkan model default.

Bidang input dan output

Cover

Menerima file video sebagai input dan menghasilkan beberapa gambar (tiga secara default). Anda harus menggunakan placeholder untuk membedakan file output. Format output berupa PNG untuk gambar statis atau GIF untuk gambar animasi, tergantung pada parameter yang ditentukan dalam JobParams.

VideoDelogo

Menghapus logo dari file video dan menghasilkan video MP4.

VideoDetext

Menghapus subtitle dari file video dan menghasilkan video MP4.

CaptionExtraction

Mengekstraksi subtitle dari file video dan menghasilkannya sebagai file SRT.

VideoGreenScreenMatting

Menerima file video sebagai input dan menghasilkan video dengan latar belakang layar hijau yang dihapus. Format output berupa MP4 atau WebM, tergantung pada parameter dalam JobParams.

FaceBeauty

Menerima file video sebagai input dan menghasilkan video dalam format MP4 dengan efek kecantikan wajah.

VideoH2V

Menerima file video sebagai input dan menghasilkan video MP4 vertikal yang dikonversi dari sumber horizontal.

MusicSegmentDetect

Menerima file audio sebagai input dan menghasilkan file JSON yang berisi hasil deteksi chorus.

AudioBeatDetection

Menerima file audio sebagai input dan menghasilkan file JSON yang berisi hasil deteksi ketukan.

AudioQualityAssessment

Menerima file audio sebagai input. Tidak ada file output yang dihasilkan. Hasil penilaian kualitas audio dikembalikan langsung dalam respons QueryIProductionJob.

SpeechDenoise

Mengurangi kebisingan dalam file audio dan menghasilkan output dalam format file WAV.

AudioMixing

Mencampur file audio input dengan trek tambahan yang ditentukan dalam JobParams dan menghasilkan output dalam format WAV.

MusicDemix

Memisahkan file audio (lagu) menjadi dua file audio terpisah: satu untuk vokal dan satu untuk iringan. Jalur Output harus menyertakan placeholder {resultType} untuk membedakan kedua file tersebut.

Bidang JSON JobParams

Cover

  • Model: String. Menentukan model Smart Cover. Jika dibiarkan kosong, gambar statis akan dihasilkan. Jika diatur ke gif, gambar animasi akan dihasilkan.

VideoDelogo

  • LogoModel: String. Menentukan jenis logo yang akan dihapus. Nilai yang valid: tv (logo siaran televisi) dan internet (logo media online). Anda dapat menentukan beberapa nilai, dipisahkan dengan koma.

  • Boxes: String. Koordinat kotak pembatas untuk logo target. Koordinat ditentukan sebagai jarak ternormalisasi dari pojok kiri atas dalam format [xmin, ymin, width, height]. Maksimal dua kotak pembatas didukung. Contoh: "[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".

VideoDetext

  • LimitRegion: Daftar. Menentukan wilayah untuk deteksi subtitle. Koordinat ditentukan sebagai jarak ternormalisasi dari pojok kiri atas dalam format [xmin, ymin, width, height]. Beberapa wilayah didukung. Contoh: [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Catatan: Jika parameter ini dihilangkan, layanan secara default akan memindai 30% bagian bawah video.

  • Time: Daftar. Menentukan rentang waktu untuk penghapusan subtitle dalam satuan detik, dalam format [start_time, end_time]. Misalnya, [5, 20] menunjukkan bahwa subtitle hanya dihapus antara detik ke-5 hingga ke-20 dalam video.
    • Array satu dimensi, seperti [5, 20], untuk menentukan satu rentang waktu.

    • Array dua dimensi, seperti [[5, 20], [25, 43], [51, 80]], untuk menentukan beberapa rentang waktu. Format ini hanya didukung saat modelId bernilai algo-video-detext-new.

CaptionExtraction

  • fps: Integer. (Opsional) Laju frame pengambilan sampel. Rentang valid: [2, 10]. Default: 5.

  • roi: Wilayah minat (ROI) untuk ekstraksi subtitle. Hanya subtitle dalam wilayah ini yang diekstraksi. Formatnya adalah [[top, bottom], [left, right]], menggunakan nilai ternormalisasi. Misalnya, [[0.5, 1], [0, 1]] menentukan separuh bagian bawah video. Jika parameter ini dihilangkan, layanan secara default akan mengekstraksi subtitle dari seperempat bagian bawah video.

  • lang: String. Bahasa untuk pengenalan. Nilai yang valid: ch (Tiongkok), en (Inggris), dan ch_ml (campuran Tiongkok dan Inggris). Default: ch.

  • track: String. Jika diatur ke main, hanya trek subtitle utama yang diekstraksi. Jika parameter ini dihilangkan, semua subtitle dalam wilayah yang ditentukan akan diekstraksi secara default.

VideoGreenScreenMatting

  • bgimage: String. URL gambar latar belakang yang akan ditumpangkan pada video setelah matting. Contoh: http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Jika parameter ini dihilangkan, layanan akan menghasilkan video WebM dengan saluran alfa.

FaceBeauty

  • beauty_params: String. Parameter untuk fitur kecantikan wajah. Contoh: "whiten=20,smooth=50,face_thin=50". Untuk informasi lebih lanjut, lihat Deskripsi Bidang Parameter.

VideoH2V

Tidak ada

MusicSegmentDetect

Tidak ada

AudioBeatDetection

Tidak ada

AudioQualityAssessment

Tidak ada

SpeechDenoise

File audio input harus dalam format WAV dengan laju pengambilan sampel 16 kHz atau 48 kHz.

AudioMixing

  • inputs: Daftar yang berisi trek audio yang akan dicampur. Catatan: Saat ini, hanya satu file yang didukung. Contoh: {"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}

MusicDemix

Tidak ada

Elemen respons

Element

Type

Description

Example

object

Data yang dikembalikan.

RequestId

string

ID permintaan.

C1849434-FC47-5DC1-92B6-F7EAAFE3851E

JobId

string

ID pekerjaan.

****20b48fb04483915d4f2cd8ac****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.