All Products
Search
Document Center

ApsaraVideo VOD:SubmitAIMediaAuditJob

Last Updated:Jun 10, 2026

Mengirimkan tugas peninjauan cerdas (intelligent review) untuk file audio atau video. Setelah dikirim, tugas diproses secara asinkron. Respons yang berhasil berarti tugas telah masuk ke antrean, bukan berarti tugas telah selesai.

Deskripsi operasi

  • Sebelum Anda memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Fitur peninjauan cerdas adalah layanan berbayar. Untuk informasi selengkapnya, kirim tiket atau hubungi manajer akun Anda.

  • Operasi ini hanya tersedia di region China (Shanghai), China (Beijing), dan Singapore.

  • Ini adalah API asinkron. Setelah Anda mengirimkan tugas, ID tugas akan dikembalikan. Tugas kemudian diproses secara asinkron. Hasil akhir dikirim melalui callback. Anda juga dapat memanggil operasi GetAIMediaAuditJob untuk membuat kueri status tugas.

  • Untuk panduan tentang pengiriman tugas peninjauan cerdas, lihat Intelligent review.

  • Setelah tugas peninjauan cerdas selesai, ApsaraVideo VOD menyimpan resource gambar yang dihasilkan dalam bucket sistem secara gratis selama dua minggu. Setelah periode tersebut, resource akan dihapus secara otomatis.

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

vod:SubmitAIMediaAuditJob

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

MediaId

string

Yes

ID file audio atau video. Untuk memperoleh ID, masuk ke konsol ApsaraVideo VOD lalu buka Review Management > Video Moderation.

fe028d09441afffb138cd7ee****

TemplateId

string

No

ID template AI. Anda dapat memperoleh ID template dengan salah satu cara berikut:

  • Panggil operasi AddAITemplate. Nilai TemplateId dalam respons adalah ID template AI.

  • Panggil operasi ListAITemplates untuk membuat kueri ID template AI yang tersedia.

Catatan

Jika Anda mengabaikan parameter ini, ApsaraVideo VOD akan menggunakan template AI default untuk peninjauan cerdas.

a07a7f7d7d10eb9fd999e56ecc****

UserData

string

No

Pengaturan kustom. Parameter ini harus berupa string JSON. Gunakan parameter ini untuk menentukan pengaturan, seperti callback pesan. Untuk informasi selengkapnya, lihat UserData.

Catatan

Untuk menggunakan fitur callback pesan, Anda harus mengonfigurasi URL callback dan memilih jenis event callback yang sesuai di konsol ApsaraVideo VOD. Jika tidak, pengaturan callback tidak akan berlaku. Untuk informasi selengkapnya tentang konfigurasi callback HTTP, lihat Callback settings.

{"MessageCallback":{"CallbackURL":"http://test.test.com"},"Extend":{"localId":"xxx","test":"www"}}

MediaType

string

No

Jenis media. Hanya video yang didukung.

video

MediaAuditConfiguration

string

No

Konfigurasi untuk tugas peninjauan.

  • Konfigurasi tambahan untuk tugas peninjauan. Saat ini hanya field ResourceType yang didukung. Gunakan field ini untuk menentukan jenis file media agar standar dan aturan peninjauan disesuaikan.

  • Untuk menyesuaikan standar dan aturan peninjauan untuk ResourceType tertentu, kirim tiket. Untuk informasi tentang cara mengirim tiket, lihat Contact us.

  • Nilai ResourceType hanya boleh berisi huruf, angka, dan garis bawah (_).

{"ResourceType":"****_movie"}

Elemen respons

Element

Type

Description

Example

object

Respons.

RequestId

string

ID permintaan.

F4631053-8D9F-42B2-4A67281DB88E****

MediaId

string

ID file audio atau video.

fe028d09441afffb138cd7ee****

JobId

string

ID tugas.

bdbc266af6893943a70176d92e99****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F4631053-8D9F-42B2-4A67281DB88E****",
  "MediaId": "fe028d09441afffb138cd7ee****",
  "JobId": "bdbc266af6893943a70176d92e99****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.