All Products
Search

This Product

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    Document Center

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    Last Updated:Jun 11, 2026

    Mengirimkan pekerjaan sensor media.

    Deskripsi operasi

    • This is an asynchronous API. After you submit a job, the system returns a job ID and queues it for asynchronous processing. The final results are delivered through a callback notification. You can also call the Query a media censor job operation to check the job status.

    • Media censorship is available in the China (Beijing), China (Shanghai), and Asia Pacific SE 1 (Singapore) regions. This feature is not supported in other regions.

    QPS limit

    The queries per second (QPS) limit for this API is 100 per user. API calls that exceed this limit are rate-limited, which can affect your business. For more information, see QPS limit.

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

    none

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Input

    string

    No

    URL OSS file media yang akan disensor. File video dan audio didukung. Anda dapat memperoleh URL dari Konsol MPS di bawah Manajemen media > Daftar Media. Untuk menyensor file gambar, gunakan parameter CoverImage. Tentukan parameter ini sebagai objek JSON. Untuk detail, lihat Detail Input.

    • Bucket: Nama bucket OSS file input.

    • Location: Wilayah OSS. Ini harus cocok dengan wilayah layanan MPS Anda.

    • Object: Objek OSS untuk Pemindaian.

      Catatan

      Nama objek tidak boleh diawali dengan garis miring (/). Jika tidak, panggilan API akan gagal.

    {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
    CoverImages

    string

    No

    URL OSS gambar sampul. Anda dapat memperoleh URL dari Konsol MPS di bawah Manajemen media > Daftar Media. Anda dapat menentukan hingga lima gambar sampul. Tentukan URL sebagai array JSON.

    • Bucket: Nama bucket OSS file input.

    • Location: Wilayah OSS. Ini harus cocok dengan wilayah layanan MPS Anda.

    • Object: Objek OSS untuk Pemindaian.

      Catatan

      Nama objek tidak boleh diawali dengan garis miring (/). Jika tidak, panggilan API akan gagal.

    [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
    Title

    string

    No

    Judul video. Panjang maksimum adalah 64 byte.

    Hello World
    Description

    string

    No

    Deskripsi video. Panjang maksimum adalah 128 byte.

    example description
    Barrages

    string

    No

    Komentar barrage, disediakan sebagai string.

    hello world
    PipelineId

    string

    No

    ID pipeline yang digunakan untuk notifikasi Paket. Anda dapat memperoleh ID dari Konsol MPS di bawah Pengaturan Global > Pipeline. Jika Anda tidak menentukan parameter ini, pipeline default akan digunakan. Pipeline default memiliki konkurensi 10. Untuk meningkatkan konkurensi, kirimkan Tiket.

    Catatan

    Saat ini, pipeline hanya dapat dibuat di Backend. Untuk mengkueri dan memperbarui pipeline, lihat Memperbarui pipeline.

    b22c173cced04565b1f38f1ecc39****
    VideoCensorConfig

    string

    Yes

    Konfigurasi sensor video dan URL OSS untuk Snapshot keluaran. Anda dapat memperoleh URL dari Konsol MPS di bawah Manajemen media > Daftar Media.

    Parameter ini adalah objek JSON.

    • OutputFile:

      • Bucket: Nama bucket OSS keluaran.

      • Location: Wilayah OSS. Ini harus sama dengan wilayah tempat layanan MPS berada.

      • Object: Objek OSS untuk keluaran. Placeholder {Count} diganti dengan nomor urut Snapshot.

      Hasil sensor detail disimpan dalam file bernama {jobId}.output di direktori yang sama dengan OutputFile. Untuk informasi tentang bidang dalam file keluaran, lihat Bidang dalam file hasil sensor media.

    • StoreVideoTimeline: Apakah akan menghasilkan file {jobId}.video_timeline dan menyimpannya di OSS. Atur nilai menjadi true untuk menghasilkan file. Jika Anda mengatur nilai menjadi false atau menghilangkan parameter, sistem tidak akan menghasilkan file. Untuk detail tentang format file, lihat Mengkueri pekerjaan media (contoh videoTimeline).

    • SaveType: Mode keluaran. abnormal hanya menyimpan Snapshot konten bermasalah. all menyimpan semua Snapshot.

    • Biztype: Templat sensor. Nilai default adalah common. Untuk menggunakan Templat sensor kustom, Anda harus mengirimkan Tiket. Setelah Templat kustom Anda dikonfigurasi, atur parameter ini ke UID Anda.

    • Scene: Skenario deteksi. Anda dapat memilih satu atau beberapa skenario. Jika Anda tidak menentukan parameter ini, sistem akan menggunakan skenario porn dan terrorism secara default. Skenario valid:

      • porn: konten pornografi

      • terrorism: konten teroris

      • ad: pelanggaran kebijakan teks-gambar

      • live: skenario yang tidak diinginkan

      • logo: logo

      • audio: anti-spam audio

    Catatan

    Untuk file input yang memiliki Track audio, skenario audio melakukan sensor audio. Jangan menentukan skenario audio untuk file input yang tidak memiliki Track audio.

    {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
    UserData

    string

    No

    Data pengguna kustom. Panjang maksimum adalah 128 byte.

    UserDatatestid-001-****
    ExternalUrl

    string

    No

    URL video.

    http://www.example.com/video-****/test-****.mp4

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The ID of the request.

    25818875-5F78-4A13-BEF6-D7393642CA58
    JobId

    string

    The ID of the media censor job. Save this ID for subsequent API calls.

    88c6ca184c0e47098a5b665e2****

    Parameter notifikasi Paket asinkron.

    ParameterTipeDeskripsi
    TypeStringTipe Paket. Nilai: MediaCensor.
    MediaCensorJobNotifyAliyunMediaCensorJobNotifyObjek notifikasi untuk pekerjaan sensor media.
    UserDataStringData pengguna kustom.

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.