Mulai cepat: Menggunakan API

Penting

Karena pengumuman penghentian Azure Media Services, Azure AI Video Indexer mengumumkan penyesuaian fitur Azure AI Video Indexer. Lihat Perubahan yang terkait dengan penghentian Azure Media Service (AMS) untuk memahami apa artinya ini untuk akun Azure AI Video Indexer Anda. Lihat panduan Mempersiapkan penghentian AMS: Pembaruan VI dan migrasi.

Azure AI Video Indexer mengonsolidasikan berbagai teknologi kecerdasan buatan (AI) audio dan video yang ditawarkan oleh Microsoft ke dalam satu layanan terintegrasi, sehingga pengembangan menjadi lebih sederhana. Azure AI Video Indexer dirancang untuk memungkinkan pengembang fokus menggunakan teknologi AI media tanpa khawatir tentang skala, jangkauan global, ketersediaan, dan keandalan platform cloud. Anda dapat menggunakan API untuk mengunggah file Anda, mendapatkan wawasan video terperinci, mendapatkan URL wawasan yang dapat disematkan, widget pemutar, dan banyak lagi.

Saat Anda mengunjungi situs web Azure AI Video Indexer untuk pertama kalinya, akun uji coba secara otomatis dibuat untuk Anda. Dengan akun uji coba, Anda mendapatkan beberapa menit pengindeksan gratis. Anda nantinya dapat menambahkan akun berbayar. Dengan opsi berbayar, Anda membayar untuk menit terindeks. Untuk detail tentang akun yang tersedia (opsi uji coba dan berbayar), lihat Jenis akun Azure AI Video Indexer.

Artikel ini memperlihatkan kepada Anda cara menggunakan AZURE AI Video Indexer API.

Prasyarat

Unggah file media. Ada dua cara:

1. Unggah file media ke URL pilihan Anda (disarankan). Anda dapat menggunakan lokasi jaringan publik. Setelah mengunggah file, Anda dapat memeriksa apakah file dapat diakses oleh AVI dengan menyalin dan menempelkannya ke bilah lokasi browser Anda. Jika Anda dapat memutar file media, kemungkinan VI juga dapat mengaksesnya. Jika Anda ingin mengamankan lokasi penyimpanan menggunakan Azure Storage Blob, unggah file dan dapatkan URL SAS. Untuk informasi selengkapnya tentang mendapatkan URL aman untuk file Anda, lihat URL SAS Azure Blob Storage. URL ini digunakan untuk menyalin file Anda ke Azure AI Video Indexer untuk pengindeksan.

2. Kirim file video array byte di isi permintaan. Untuk informasi selengkapnya tentang mengunggah file media sebagai array byte dalam isi permintaan, lihat Mengunggah blob dengan .NET.

Catatan

Ada batas permintaan API 10 permintaan per detik dan hingga 120 permintaan per menit.

Berlangganan API

Penting

• Anda harus menggunakan email yang sama dengan yang Anda gunakan saat mendaftar untuk Azure AI Video Indexer.
• Akun pribadi Google dan Microsoft (Outlook/Live) hanya dapat digunakan untuk akun percobaan. Akun yang tersambung ke Azure memerlukan ID Entra.
• Hanya ada satu akun aktif per email. Jika pengguna mencoba masuk dengan user@gmail.com untuk LinkedIn dan kemudian dengan user@gmail.com untuk Google, yang terakhir akan menampilkan halaman kesalahan, yang mengatakan bahwa pengguna sudah ada.
• Kunci harus dilindungi. Kunci hanya boleh digunakan oleh kode server Anda. Mereka seharusnya tidak tersedia di sisi klien (.js, .html, dan seterusnya).

1. Masuk ke portal pengembang AZURE AI Video Indexer API.
2. Berlangganan dengan memilih tab Produk . Lalu, pilih Otorisasi dan berlangganan. Pengguna baru secara otomatis berlangganan Otorisasi.
3. Temukan, salin, dan simpan kunci primer dan sekunder. Anda dapat menemukan langganan di Profil Anda. Kunci primer dan sekunder ada di bagian Langganan .
4. Pilih tautan Perlihatkan untuk Kunci primer dan kunci Sekunder. Salin dan tempelkan ke editor teks hingga Anda siap menggunakannya dalam file variabel lingkungan Anda.

Mendapatkan token akses menggunakan API Otorisasi

Anda tidak ingin memberikan akses penuh ke setiap pengguna untuk aplikasi Anda. Ada beberapa tingkat akses untuk VI.

Tingkat	Lihat video	Memproses video	Menampilkan proyek	Proyek proses	Menampilkan akun	Mengelola akun
Pembaca Video	✔️
Kontributor Video	✔️	✔️
Pembaca Proyek	✔️		✔️
Kontributor Proyek	✔️	✔️	✔️	✔️
Pembaca Akun	✔️		✔️		✔️
Kontributor Akun	✔️	✔️	✔️	✔️	✔️	✔️

Membuat dan mengirim permintaan token akses

Atur subscription-idresource-group-name, , VI account-name dalam permintaan dan atur scope parameter dan permissionType dalam isi permintaan ke tingkat akses yang Anda butuhkan.

Misalnya, jika Anda ingin memberikan akses ke pengguna sehingga mereka dapat bekerja dengan proyek tetapi tidak dapat bekerja dengan akun, atur permissionType ke "Kontributor" dan scope ke "Proyek." JIKA mengatur izin untuk proyek, berikan projectId.

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.VideoIndexer/accounts/{account-name}/generateAccessToken?api-version=2024-01-01

{
  "permissionType": "Reader",
  "scope": "Project",
  "projectId": "07ec9e38d4"
}

Respon sampel

{
  "accessToken": "<jwt token of 1260 characters length>"
}

Untuk contoh selengkapnya tentang mengatur cakupan dan jenis izin, lihat VI REST API.

Mulai menggunakan API

Anda siap untuk mulai menggunakan API. Temukan deskripsi terperinci dari setiap REST API Azure AI Video Indexer.

Untuk contoh terperinci menggunakan kunci dalam file variabel lingkungan Anda, dan menggunakan token akses lihat sampel Azure AI Video Indexer.

Rekomendasi

• Saat Anda memanggil API yang mendapatkan wawasan video untuk video yang ditentukan, Anda mendapatkan output JSON mendetail sebagai konten respons. Lihat detail tentang JSON yang dikembalikan dalam artikel ini.
• Output JSON yang dihasilkan oleh API berisi Insights elemen dan SummarizedInsights . Kami sangat menyarankan penggunaan Insights dan tidak menggunakan SummarizedInsights (yang ada untuk kompatibilitas mundur).
• Kami tidak menyarankan Anda menggunakan data langsung dari folder artefak untuk tujuan produksi. Artefak adalah output menengah dari proses pengindeksan dan merupakan output mentah dari berbagai mesin AI yang menganalisis video. Skema artefak dapat berubah dari waktu ke waktu.
• Gunakan Get Video Index API, seperti yang dijelaskan dalam Mendapatkan wawasan dan artefak yang dihasilkan oleh API dan bukanGet-Video-Artifact-Download-Url.