All Products
Search

This Product

    Intelligent Media Services:SubmitIProductionJob

    Document Center

    Intelligent Media Services:SubmitIProductionJob

    Last Updated:Aug 06, 2026

    Mengirimkan pekerjaan produksi cerdas dengan memanggil SubmitIProductionJob.

    Deskripsi operasi

    Ini adalah operasi asinkron. Setelah pekerjaan dikirimkan, ID pekerjaan akan dikembalikan. Pada tahap ini, pekerjaan belum selesai dan masuk ke antrian latar belakang untuk dieksekusi secara asinkron. Hasil akhir dikirimkan melalui notifikasi callback. Anda juga dapat menanyakan status pekerjaan secara proaktif dengan memanggil QueryIProductionJob.

    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 task
    FunctionName

    string

    Yes

    Nama fungsi algoritma yang digunakan. Nilai yang valid:

    • Cover: cover cerdas

    • VideoClip: ringkasan video

    • VideoDelogo: penghapusan logo video

    • VideoDetext: penghapusan subtitle video

    • CaptionExtraction: ekstraksi teks

    • VideoGreenScreenMatting: image matting

    • FaceBeauty: perawatan wajah video

    • VideoH2V: landscape-to-portrait cerdas

    • MusicSegmentDetect: deteksi chorus

    • AudioBeatDetection: deteksi beat

    • AudioQualityAssessment: penilaian kualitas audio

    • SpeechDenoise: denoising suara

    • AudioMixing: mixing audio

    • MusicDemix: pemisahan vokal dan iringan

    Cover
    Input

    object

    Yes

    Media input. Mendukung path Object Storage Service (OSS) dan ID aset media.

    Fungsi algoritma yang berbeda memiliki persyaratan file input yang berbeda. Untuk informasi selengkapnya, lihat deskripsi tambahan di bawah.

    Type

    string

    Yes

    Jenis media. Nilai yang valid:

    • OSS: path OSS

    • Media: ID aset media

    OSS
    Media

    string

    Yes

    Media input. Mendukung path OSS dan ID aset media. Aturan path OSS (gunakan salah satu format berikut):

    1. oss://bucket/object

    2. http(s)://bucket.oss-[regionId].aliyuncs.com/object di mana bucket adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan object adalah path file.

    oss://bucket/object
    Output

    object

    Yes

    Media output. Mendukung path OSS dan ID aset media.

    Fungsi algoritma yang berbeda menghasilkan file output yang berbeda. Untuk informasi selengkapnya, lihat deskripsi tambahan di bawah.

    Type

    string

    Yes

    Jenis media. Nilai yang valid:

    • OSS: path OSS

    • Media: ID aset media

    OSS
    Biz

    string

    No

    Jenis bisnis tempat aset media tersebut berada.

    IMS
    Media

    string

    Yes

    Media output. Jika Type diatur ke OSS, tentukan path OSS. Jika Type diatur ke Media, tentukan ID aset media.

    Aturan path OSS (gunakan salah satu format berikut):

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object di mana bucket adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan object adalah path file.

    ID aset media:

    • Anda dapat menentukan MediaId yang sudah ada.

      • Anda tidak perlu menentukan Biz. Nilainya mengikuti sumber.

    • Anda dapat membuat MediaId baru (biarkan MediaId kosong).

      • Nilai Biz menentukan apakah aset media ditulis ke IMS atau VOD. Jika Biz tidak ditentukan, nilainya mengikuti sumber atau default ke IMS.

    Catatan

    Path OSS mendukung placeholder, seperti oss://example-****/iproduction/{source}-{timestamp}-{sequenceId}.png. Placeholder berikut didukung:

    • {source}: diisi dengan nama file input

    • {timestamp}: diisi dengan Stempel waktu UNIX

    • {sequenceId}: diisi dengan nomor urut generasi

    • {resultType}: diisi dengan jenis file output (ditentukan oleh server) Placeholder tidak wajib. Namun, untuk algoritma dengan beberapa output, seperti cover cerdas, sertakan placeholder nomor urut untuk memastikan path file output unik.

    oss://bucket/object
    OutputUrl

    string

    No

    Path OSS file output ketika 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. Ini adalah objek JSON. Parameter bervariasi tergantung pada algoritma. Untuk informasi selengkapnya, lihat deskripsi tambahan.

    {"Model":"gif"}
    ScheduleConfig

    object

    No

    Konfigurasi penjadwalan pekerjaan.

    PipelineId

    string

    No

    ID pipeline.

    5246b8d12a62433ab77845074039c3dc
    Priority

    integer

    No

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

    6
    UserData

    string

    No

    Data pengguna kustom, yang dikembalikan apa adanya saat Anda mengambil hasilnya. Nilai dapat memiliki panjang hingga 256 karakter.

    {"test":1}
    ModelId

    string

    No

    ID model algoritma. Jika parameter ini dibiarkan kosong, model default untuk fungsi yang sesuai akan digunakan. Dalam kebanyakan kasus, biarkan parameter ini kosong untuk menggunakan model default.

    Fungsi algoritma berikut memiliki model non-default yang tersedia:

    • VideoDetext

      • ModelId = algo-video-detext-new: algoritma penghapusan subtitle dengan hasil lebih baik tetapi kecepatan lebih lambat dan biaya lebih tinggi dibandingkan algoritma default.

    Deskripsi bidang Input dan Output

    Cover

    Input: file video. Output: beberapa gambar (secara default 3, dibedakan oleh placeholder) dalam format PNG atau GIF (tergantung pada parameter JobParams yang menentukan apakah gambar statis atau animasi yang dihasilkan).

    VideoDelogo

    Input: file video. Output: video dengan logo dihapus (dalam format MP4).

    VideoDetext

    Input: file video. Output: video dengan subtitle dihapus (dalam format MP4).

    CaptionExtraction

    Input: file video. Output: file subtitle (dalam format SRT).

    VideoGreenScreenMatting

    Input: file video. Output: video setelah image matting (dalam format MP4 atau WebM, tergantung pada parameter JobParams).

    FaceBeauty

    Input: file video. Output: video dengan perawatan wajah diterapkan (dalam format MP4).

    VideoH2V

    Input: file video. Output: video landscape-to-portrait (dalam format MP4).

    MusicSegmentDetect

    Input: file audio. Output: file hasil berisi informasi deteksi chorus (dalam format JSON).

    AudioBeatDetection

    Input: file audio. Output: file hasil berisi informasi deteksi beat (dalam format JSON).

    AudioQualityAssessment

    Input: file audio. Tidak ada file output yang dihasilkan. Hasil penilaian kualitas audio dikembalikan langsung dalam respons QueryIProductionJob.

    SpeechDenoise

    Input: file audio. Output: file audio yang telah didenoise (dalam format WAV).

    AudioMixing

    Input: file audio yang akan di-mix. Output: file audio yang telah di-mix (dalam format WAV). Untuk informasi tentang cara menentukan file audio yang akan di-mix, lihat parameter JobParams di bawah.

    MusicDemix

    Input: file audio (lagu). Output: dua file audio setelah pemisahan vokal dan iringan. Sertakan placeholder {resultType} dalam path Output untuk membedakan antara track vokal dan track latar.

    Deskripsi bidang JSON JobParams

    Cover

    • Model: String. Model cover cerdas. Jika dibiarkan kosong, cover gambar dihasilkan. Jika diatur ke gif, cover animasi dihasilkan.

    VideoDelogo

    • LogoModel: String. Jenis logo yang akan dihapus. Nilai yang valid: tv (logo umum—stasiun TV), internet (logo umum—media online). Beberapa nilai dapat ditentukan, dipisahkan dengan koma.

    • Boxes: String. Posisi kotak logo target, ditentukan sebagai jarak ternormalisasi dari pojok kiri atas: [xmin, ymin, width, height]. Mendukung hingga dua kotak logo target. Contoh: "[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".

    VideoDetext

    • LimitRegion: List. Wilayah deteksi subtitle terbatas, ditentukan sebagai jarak ternormalisasi dari pojok kiri atas: [xmin, ymin, width, height]. Mendukung beberapa wilayah deteksi. Contoh: [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Jika parameter ini tidak diatur, wilayah deteksi default adalah 30% bagian bawah video.

    • Time: Rentang waktu penghapusan global (dalam detik). Jenis list, mencakup waktu mulai dan waktu akhir: [start_time, end_time]. Contoh: [5, 20], yang berarti hanya subtitle antara detik ke-5 hingga ke-20 video yang dihapus.

      • Parameter Time dapat berupa array satu dimensi, seperti [5, 20], untuk menentukan rentang waktu tunggal.

      • Parameter Time juga dapat berupa array dua dimensi, seperti [[5, 20], [25, 43], [51, 80]], untuk menentukan beberapa rentang waktu (hanya didukung ketika modelId=algo-video-detext-new).

    CaptionExtraction

    • fps: Laju frame pengambilan sampel (opsional). Integer. Nilai yang valid: 2 hingga 10. Nilai default: 5.

    • roi: Wilayah pemilihan subtitle (hanya subtitle dalam wilayah ini yang diekstraksi). Format: [[top, bottom], [left, right]], dengan nilai ternormalisasi (misalnya, separuh bawah: [[0.5, 1], [0, 1]]). Jika parameter ini tidak ditentukan, seperempat bagian bawah video digunakan secara default.

    • lang: Bahasa pengenalan. Nilai yang valid: ch (Tiongkok), en (Inggris), ch_ml (campuran Tiongkok-Inggris). Nilai default: ch.

    • track: Jika diatur ke "main", hanya track subtitle utama yang diekstraksi. Jika tidak ditentukan, semua subtitle dalam wilayah tersebut diekstraksi secara default.

    VideoGreenScreenMatting

    • bgimage: Gambar latar belakang yang akan ditimpa setelah matting. Contoh: http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Jika parameter ini tidak ditentukan, video WebM dengan channel transparan dioutputkan.

    FaceBeauty

    • beauty_params: Parameter perawatan wajah. Contoh: "whiten=20,smooth=50,face_thin=50". Untuk informasi selengkapnya, 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 sampel harus 16 kHz atau 48 kHz.

    AudioMixing

    • inputs: Daftar URL file track audio yang akan di-mix. Hanya satu file yang didukung. Contoh: {"file":"http://example-bucket-****.oss-ap-southeast-1.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 produksi 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.