All Products
Search

This Product

    ApsaraVideo Media Processing:SubmitIProductionJob

    Document Center

    ApsaraVideo Media Processing:SubmitIProductionJob

    Last Updated:Jun 11, 2026

    Mengirimkan pekerjaan produksi cerdas.

    Deskripsi operasi

    Operasi ini mengirimkan pekerjaan untuk dieksekusi secara asinkron. Sistem menambahkan setiap pekerjaan ke pipeline untuk penjadwalan, antrean, dan pemrosesan. Anda dapat mengambil hasil pekerjaan dengan memanggil operasi QueryIProductionJob atau melalui notifikasi pesan asinkron.

    Batas QPS

    Batas QPS untuk operasi ini adalah 100 kueri per detik (QPS) untuk setiap pengguna. Jika Anda melebihi batas ini, panggilan API akan dikenakan pembatasan laju. Untuk informasi selengkapnya, lihat Batas QPS.

    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

    mts:SubmitIProductionJob

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    FunctionName

    string

    Yes

    Nama fungsi. Untuk informasi tentang region yang mendukung setiap fungsi, lihat Region layanan. Nilai yang valid:

    • VideoH2V: Mengonversi video lanskap menjadi video potret.

    • VideoDelogo: Menghapus tanda air atau logo dari video.

    • Cover: Menghasilkan sampul cerdas.

    • VideoClip: Menghasilkan ringkasan video.

    • ImageH2V: Mengonversi gambar lanskap menjadi gambar potret.

    • ImageDelogo: Menghapus tanda air atau logo dari gambar.

    • CaptionExtraction: Melakukan [ekstraksi teks]. Algoritme mengekstrak teks dari video input dan mengembalikan berkas teks.

    • VideoDetext: Menghapus subtitle yang tertanam (hard-coded) dari video.

    • VideoGreenScreenMatting: Melakukan matting layar hijau. Algoritme menggabungkan video layar hijau input dengan gambar latar belakang dan mengembalikan video hasil.

    • MusicSegmentDetect: Melakukan deteksi chorus. Algoritme mendeteksi segmen chorus dalam berkas audio atau video input dan mengembalikan waktu mulai dan akhirnya. Jika tidak ada chorus yang terdeteksi, hasilnya kosong.

    • AudioMixing: Melakukan pencampuran audio.

    • AudioBeatDetection: Melakukan deteksi ketukan. Algoritme mengambil URL berkas audio atau video sebagai input dan menghasilkan daftar stempel waktu ketukan (BeatList) dan daftar stempel waktu downbeat (DownBeatList).

    • ImageCartoonize: Menerapkan efek 3D atau bergaya pada wajah. Untuk menggunakan fitur stilisasi wajah, hubungi kami di DingTalk pada yuanzhigao1209.

    • AudioQualityAssessment: Menilai kualitas audio.

    • FaceBeauty: Menerapkan filter kecantikan pada wajah dalam video.

    • SpeechDenoise: Melakukan reduksi kebisingan cerdas.

      Catatan

      Untuk penilaian kualitas audio, audio input harus berupa berkas WAV terkuantisasi 16-bit. Saluran mono dan stereo didukung. Laju pengambilan sampel yang didukung berkisar dari 8.000 Hz hingga 48.000 Hz.

    ImageCartoonize
    ModelId

    string

    No

    ID model algoritme. Jika Anda tidak menentukan parameter ini, sistem menggunakan model default untuk fungsi tersebut.

    null
    JobParams

    string

    No

    Parameter pekerjaan untuk algoritme, ditentukan sebagai objek JSON. Konten parameter ini bervariasi tergantung pada algoritmenya. Untuk informasi selengkapnya, lihat Parameter tambahan untuk pekerjaan produksi cerdas.

    {"Model":"gif"}
    ScheduleParams

    string

    No

    Parameter penjadwalan pekerjaan opsional.

    null
    NotifyUrl

    string

    No

    URL callback. Hanya antrean pesan MNS yang didukung. Anda dapat menemukan jalur antrean pesan di konsol MNS dengan menavigasi ke Queues > Details.

    mns://125340688170****.mns.cn-beijing.aliyuncs.com/queues/example-pipeline
    UserData

    string

    No

    Data kustom opsional yang dikembalikan oleh layanan dalam notifikasi callback.

    {\"key\":\"value\"}
    PipelineId

    string

    No

    ID pipeline pekerjaan. Anda dapat memperoleh ID pipeline dari konsol MPS dengan menavigasi ke Global Settings > Pipelines. ID ini menentukan antrean callback pekerjaan dan menyediakan isolasi penyewa. Jika Anda tidak menentukan parameter ini, pipeline default akan digunakan. Pipeline default memiliki konkurensi sebesar 10 dan tidak terikat pada antrean pesan untuk notifikasi.

    39f8e0bc005e4f309379701645f4****
    Input

    string

    No

    Berkas input dalam bucket OSS. Hanya jalur OSS yang didukung. Berkas harus berada dalam bucket OSS di region yang sama dengan layanan MPS. Anda dapat memperoleh jalur dari konsol MPS dengan menavigasi ke Media Management > Media List, atau dari konsol OSS dengan memilih bucket yang sesuai.

    Catatan

    Parameter Input diperlukan untuk beberapa algoritme. Tentukan parameter ini berdasarkan kebutuhan bisnis Anda.

    oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
    Output

    string

    No

    Berkas output dalam bucket OSS. Hanya jalur OSS yang didukung. Bucket OSS tujuan harus berada di region yang sama dengan layanan MPS. Anda dapat memperoleh jalur dari konsol MPS dengan menavigasi ke Media Management > Media List, atau dari konsol OSS dengan memilih bucket yang sesuai.

    Catatan

    Formatnya adalah oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt. Dalam format ini, {source}, {timestamp}, dan {sequenceId} adalah placeholder. Sistem menggantinya masing-masing dengan nama berkas input, stempel waktu Unix, dan nomor urut. Placeholder tidak diharuskan. Namun, untuk algoritme yang menghasilkan beberapa output, seperti sampul cerdas, Anda harus menyertakan placeholder nomor urut seperti {sequenceId} untuk memastikan setiap berkas output memiliki jalur yang unik. Anda dapat menentukan ekstensi berkas.

    oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter yang dikembalikan.

    RequestId

    string

    ID permintaan.

    5210DBB0-E327-4D45-ADBC-0B83C8796E26
    JobId

    string

    ID pekerjaan. Simpan ID ini untuk kueri berikutnya.

    39f8e0bc005e4f309379701645f4****
    Result

    string

    Hasil pekerjaan. Struktur hasilnya bervariasi tergantung pada algoritmenya. Untuk informasi selengkapnya, lihat Parameter tambahan untuk pekerjaan produksi cerdas.

    { "Code":"Success", "Details":[], "FunctionName":"ImageCartoonize", "JobId":"39f8e0bc005e4f309379701645f4****", "Message":"success", "State":"Success", "Type":"IProduction" }

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "Result": "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.