SubmitAIJob - ApsaraVideo VOD

Deskripsi operasi

Pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD sebelum memanggil operasi ini. Penggunaan fitur smart tagging dan video fingerprinting akan dikenai biaya. Untuk informasi selengkapnya, lihat Penagihan video AI.
Wilayah yang mendukung fitur video fingerprinting: China (Beijing), China (Shanghai), dan Singapore. Wilayah yang mendukung fitur smart tagging: China (Beijing) dan China (Shanghai).
Anda harus mengaktifkan fitur video fingerprinting atau smart tagging terlebih dahulu sebelum dapat memanggil operasi ini untuk mengirimkan pekerjaan. Untuk informasi selengkapnya, lihat Ikhtisar.
Jika ini pertama kalinya Anda menggunakan fitur video fingerprinting, Anda perlu mengajukan tiket untuk meminta penggunaan media fingerprint library secara gratis. Jika tidak, fitur video fingerprinting akan terpengaruh. Untuk informasi tentang cara mengajukan tiket, lihat Hubungi kami.
Setelah pekerjaan AI dikirimkan, ApsaraVideo VOD memprosesnya secara asinkron. Operasi ini mungkin mengembalikan respons sebelum pekerjaan selesai. Anda dapat mengonfigurasi fitur Event Notification dan menyetel event callback ke AI Processing Completed. Setelah menerima notifikasi tersebut, Anda dapat mengkueri hasil eksekusi pekerjaan AI.

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

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MediaId	string	No	ID video. Anda dapat memperoleh ID dengan salah satu metode berikut: Login ke Konsol ApsaraVideo VOD. Di panel navigasi kiri, pilih Media Files > Audio/Video. Pada halaman Video and Audio, lihat ID file audio atau video tersebut. Metode ini berlaku untuk file yang diunggah melalui Konsol ApsaraVideo VOD. Ambil nilai VideoId dari respons operasi CreateUploadVideo yang Anda panggil untuk mengunggah file media. Ambil nilai VideoId dari respons operasi SearchMedia setelah Anda mengunggah file media.	3D3D12340d9401fab46a0b847****
Types	string	No	Tipe pekerjaan AI. Pisahkan beberapa tipe dengan koma (,). Nilai yang valid: AIMediaDNA: Pekerjaan media fingerprinting. AIVideoTag: Pekerjaan smart tagging.	AIVideoTag
Config	string	No	Konfigurasi pekerjaan AI. Nilainya berupa string JSON. Jika Anda menyetel `Types` ke `AIVideoTag`, Anda dapat menentukan `AnalyseTypes` untuk `Config` guna mengatur algoritma analisis pekerjaan smart tagging. Nilai yang valid: ASR: automatic speech recognition (ASR) OCR: image optical character recognition (OCR) Jika Anda menyetel `Types` ke `AIMediaDNA`, Anda dapat menentukan `DNADBId` untuk `Config` guna mengatur ID media fingerprint library untuk pekerjaan video fingerprinting.	{"AIVideoTag": {"AnalyseTypes": "Face,ASR"} }
UserData	string	No	Pengaturan kustom. Nilainya berupa string JSON. Untuk informasi selengkapnya, lihat Parameter permintaan.	{"Extend":{"localId":"***","test":"www"}}

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
RequestId	string	ID permintaan.	25818875-5F78-4A13-BEF6-D73936****
AIJobList	object
AIJob	array<object>	Informasi mengenai pekerjaan AI.
	object	Detail pekerjaan AI.
Type	string	Tipe pekerjaan AI. Nilai yang valid: AIMediaDNA: Pekerjaan media fingerprinting. AIVideoTag: Pekerjaan smart tagging.	AIVideoTag
JobId	string	ID pekerjaan AI.	9e82640c85114bf5af23edfaf****
MediaId	string	ID video.	3D3D12340d92c641401fab46a0b847****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4A13-BEF6-D73936****",
  "AIJobList": {
    "AIJob": [
      {
        "Type": "AIVideoTag",
        "JobId": "9e82640c85114bf5af23edfaf****",
        "MediaId": "3D3D12340d92c641401fab46a0b847****"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.