All Products
Search
Document Center

Intelligent Media Services:SubmitIProductionJob

Last Updated:Oct 12, 2026

Mengirimkan pekerjaan produksi cerdas.

Deskripsi operasi

Operasi ini merupakan operasi asinkron. Setelah pekerjaan dikirimkan, ID pekerjaan akan dikembalikan. Pekerjaan belum selesai dan akan dimasukkan ke dalam antrean untuk dieksekusi secara asinkron di latar belakang. Hasil akhir dikirimkan melalui notifikasi callback. Anda juga dapat memanggil Query an intelligent production job untuk mengkueri status pekerjaan.

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

*Semua Sumber daya.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

No

Nama pekerjaan. Nama dapat memiliki panjang hingga 100 karakter.

Test job

FunctionName

string

Yes

Nama fitur algoritma yang akan digunakan. Nilai valid:

  • Cover: Sampul cerdas.

  • VideoClip: Sinopsis video.

  • VideoDelogo: Penghapusan ikon video.

  • VideoDetext: Penghapusan subtitle video.

  • CaptionExtraction: Pengambilan subtitle.

  • VideoGreenScreenMatting: Matting gambar.

  • FaceBeauty: Pemercantik wajah video.

  • VideoH2V: Konversi video lanskap ke potret.

  • MusicSegmentDetect: Deteksi chorus.

  • AudioBeatDetection: Deteksi beat.

  • AudioQualityAssessment: Penilaian kualitas audio.

  • SpeechDenoise: Pengurangan kebisingan suara.

  • AudioMixing: Pencampuran audio.

  • MusicDemix: Pemisahan vokal dan iringan.

Cover

Input

object

Yes

Media input. Jalur OSS dan ID aset media didukung. Persyaratan file untuk media input bervariasi berdasarkan fitur algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan di bawah.

Type

string

Yes

Tipe media. Nilai valid:

  • OSS: jalur OSS.

  • Media: ID aset media.

OSS

Media

string

Yes

Media input. URL OSS dan ID aset media didukung. URL OSS harus dalam salah satu format berikut:

  1. oss://bucket/object

  2. http(s)://bucket.oss-[regionId].aliyuncs.com/object Dalam format tersebut, bucket adalah nama bucket OSS yang berada di wilayah yang sama dengan proyek saat ini, dan objek adalah jalur file.

oss://bucket/object

Output

object

Yes

Media output. Jalur OSS dan ID aset media didukung. File output bervariasi berdasarkan fitur algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan di bawah.

Type

string

Yes

Tipe media. Nilai valid:

  • OSS: jalur OSS.

  • Media: ID aset media.

OSS

Biz

string

No

Bisnis tempat aset media berada.

Valid values:

  • VOD :

    ApsaraVideo VOD.

  • IMS :

    Intelligent Media Services.

IMS

Media

string

Yes

Media output. Jika Type diatur ke OSS, masukkan URL OSS. Jika Type diatur ke Media, masukkan ID aset media.

URL OSS harus dalam salah satu format berikut:

  1. oss://bucket/object

  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object Dalam format tersebut, bucket adalah nama bucket OSS yang berada di wilayah yang sama dengan proyek saat ini, dan objek adalah jalur file.

ID aset media:

  • Anda dapat menentukan MediaId yang sudah ada.

    • Anda tidak perlu menentukan Biz. Nilai mengikuti sumber.

  • Anda dapat membuat MediaId (biarkan MediaId kosong).

    • Sistem menentukan apakah akan menulis aset media ke IMS atau VOD berdasarkan Biz. Jika Biz tidak ditentukan, nilai mengikuti sumber atau default ke IMS.

Catatan

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

  • {source}: nama file input.

  • {timestamp}: stempel waktu UNIX.

  • {sequenceId}: nomor urut yang dihasilkan.

  • {resultType}: tipe file output, yang ditentukan oleh server. Placeholder bersifat opsional. Namun, untuk algoritma dengan beberapa output, seperti sampul cerdas, Anda harus menambahkan placeholder nomor urut untuk memastikan bahwa jalur file output bersifat unik.

oss://bucket/object

OutputUrl

string

No

URL OSS dari file output saat Type diatur ke Media. 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. Nilai berupa objek JSON. Parameter bervariasi berdasarkan algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan.

{"Model":"gif"}

ScheduleConfig

object

No

Konfigurasi penjadwalan pekerjaan.

PipelineId

string

No

ID pipeline.

5246b8d12a62433ab77845074039c3dc

Priority

integer

No

Prioritas pekerjaan. Nilai valid: 1 hingga 10. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

6

UserData

string

No

Data pengguna kustom. Data dikembalikan apa adanya saat hasil diperoleh. Nilai dapat memiliki panjang hingga 256 karakter.

{"test":1}

ModelId

string

No

ID model algoritma. Jika parameter ini dibiarkan kosong, model default untuk fitur yang sesuai akan digunakan. Anda dapat membiarkan parameter ini kosong dan menggunakan model default dalam sebagian besar kasus.

Fitur algoritma berikut mendukung model non-default:

  • VideoDetext
    • ModelId = algo-video-detext-new: algoritma penghapusan subtitle yang memberikan hasil lebih baik tetapi berjalan lebih lambat dan biaya lebih tinggi daripada algoritma default.

Deskripsi bidang input dan output.

Cover

Mengambil file video sebagai input dan menghasilkan beberapa gambar (tiga secara default, yang harus dibedakan dengan placeholder) dalam format PNG atau GIF. Gambar statis atau animasi dihasilkan berdasarkan parameter di JobParams.

VideoDelogo

Mengambil file video sebagai input dan menghasilkan video dengan logo yang dihapus dalam format MP4.

VideoDetext

Mengambil file video sebagai input dan menghasilkan video dengan subtitle yang dihapus dalam format MP4.

CaptionExtraction

Mengambil file video sebagai input dan menghasilkan file subtitle dalam format SRT.

VideoGreenScreenMatting

Mengambil file video sebagai input dan menghasilkan video setelah matting gambar dalam format MP4 atau WebM, tergantung pada parameter JobParams.

FaceBeauty

Mengambil file video sebagai input dan menghasilkan video dengan wajah yang dipercantik dalam format MP4.

VideoH2V

Mengambil file video sebagai input dan menghasilkan video yang dikonversi dari lanskap ke potret dalam format MP4.

MusicSegmentDetect

Mengambil file audio sebagai input dan menghasilkan file hasil setelah deteksi chorus dalam format JSON.

AudioBeatDetection

Mengambil file audio sebagai input dan menghasilkan file hasil setelah deteksi beat dalam format JSON.

AudioQualityAssessment

Mengambil file audio sebagai input dan tidak menghasilkan file output. Hasil penilaian kualitas audio dikembalikan langsung dalam tanggapan QueryIProductionJob.

SpeechDenoise

Mengambil file audio sebagai input dan menghasilkan file audio dengan kebisingan yang dikurangi dalam format WAV.

AudioMixing

Mengambil file audio yang akan dicampur sebagai input dan menghasilkan audio yang telah dicampur dalam format WAV. Untuk informasi lebih lanjut tentang cara memasukkan file audio yang akan dicampur, lihat parameter JobParams di bawah.

MusicDemix

Mengambil file audio (lagu) sebagai input dan menghasilkan dua file audio setelah pemisahan vokal dan iringan. Anda harus menyertakan placeholder {resultType} di jalur output untuk mewakili audio vokal dan latar belakang masing-masing.

Deskripsi bidang JSON dari JobParams.

Cover

  • Model: model sampul cerdas. Nilai bertipe String. Jika parameter ini dibiarkan kosong, sampul gambar akan dihasilkan. Jika parameter ini diatur ke gif, sampul animasi akan dihasilkan.

VideoDelogo

  • LogoModel: tipe logo yang akan dihapus. Nilai bertipe String. Nilai valid: tv (logo umum - stasiun TV) dan internet (logo umum - media online). Anda dapat menentukan beberapa nilai yang dipisahkan oleh koma (,).

  • Boxes: posisi kotak logo target. Nilai bertipe String. Posisi direpresentasikan oleh jarak ternormalisasi dari sudut kiri atas sebagai titik asal, dalam format [xmin, ymin, width, height]. Hingga dua kotak logo target didukung. Contoh: "[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".

VideoDetext

  • LimitRegion: area deteksi subtitle. Nilai bertipe List. Area direpresentasikan oleh jarak ternormalisasi dari sudut kiri atas sebagai titik asal, dalam format [xmin, ymin, width, height]. Beberapa area deteksi didukung. Contoh: [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Catatan: Jika parameter ini tidak ditentukan, area deteksi default adalah 30% bagian bawah video.

  • Time: rentang waktu penghapusan subtitle global, dalam detik. Nilai bertipe List dan mencakup waktu mulai dan waktu akhir dalam format [start_time, end_time]. Contoh: [5, 20], yang menunjukkan bahwa hanya subtitle antara detik ke-5 dan ke-20 video yang dihapus.
    • Parameter Time dapat berupa array satu dimensi, seperti [5, 20], untuk menentukan satu periode waktu.

    • Parameter Time juga dapat berupa array dua dimensi, seperti [[5, 20], [25, 43], [51, 80]], untuk menentukan beberapa periode waktu. Ini hanya didukung saat modelId diatur ke algo-video-detext-new.

CaptionExtraction

  • fps: laju bingkai pengambilan sampel. Parameter ini bersifat opsional. Nilai berupa bilangan bulat. Nilai valid: [2, 10]. Nilai default: 5.

  • roi: area pemilihan subtitle. Hanya subtitle dalam area ini yang diekstrak. Formatnya adalah [[top, bottom], [left, right]], dan nilai dinormalisasi (misalnya, [[0.5, 1], [0, 1]] untuk bagian bawah). Jika parameter ini tidak ditentukan, 1/4 bagian bawah video dikenali secara default.

  • lang: bahasa pengenalan. Nilai valid: ch (Mandarin), en (Inggris), dan ch_ml (campuran Mandarin dan Inggris). Nilai default: ch.

  • track: Jika parameter ini diatur ke "main", hanya trek subtitle utama yang diekstrak. Jika parameter ini tidak ditentukan, semua subtitle yang muncul di area diekstrak secara default.

VideoGreenScreenMatting

  • bgimage: gambar latar belakang yang akan ditumpangkan setelah matting. Contoh: http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Jika parameter ini tidak ditentukan, video WebM dengan saluran alpha akan dihasilkan.

FaceBeauty

  • beauty_params: parameter pemercantik 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

Persyaratan audio input: Format harus WAV, dan laju pengambilan sampel harus 16 kHz atau 48 kHz.

AudioMixing

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

MusicDemix

Tidak ada.

Elemen respons

Element

Type

Description

Example

object

Skema Respons.

RequestId

string

ID permintaan.

C1849434-FC47-5DC1-92B6-F7EAAFE3851E

JobId

string

ID pekerjaan cerdas.

****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.