Rövid útmutató: Az API használata

Fontos

Az Azure Media Services kivonási bejelentése miatt az Azure AI Video Indexer bejelenti az Azure AI Video Indexer funkcióinak módosításait. Az Azure Media Service (AMS) kivonásával kapcsolatos változásokért tekintse meg az Azure AI Video Indexer-fiókjának jelentését. Tekintse meg az AMS-kivonás előkészítése: VI frissítési és migrálási útmutatót.

Az Azure AI Video Indexer a Microsoft által kínált különféle hang- és video-mesterségesintelligencia-technológiákat (AI) egyetlen integrált szolgáltatásba egyesíti, így egyszerűbbé válik a fejlesztés. Az Azure AI Video Indexer úgy lett kialakítva, hogy a fejlesztők a média AI-technológiák használatára összpontosíthassanak anélkül, hogy a felhőplatformok méretével, globális elérhetőségével, rendelkezésre állásával és megbízhatóságával kellene foglalkozniuk. Az API-val feltöltheti a fájlokat, részletes videóelemzéseket kaphat, beágyazható elemzések URL-címeit, lejátszó widgeteket stb.

Amikor első alkalommal látogatja meg az Azure AI Video Indexer webhelyét, a rendszer automatikusan létrehoz egy próbafiókot. A próbafiókkal ingyenes indexelési perceket kaphat. Később hozzáadhat egy fizetős fiókot. A fizetős lehetőséggel az indexelt percekért kell fizetnie. Az elérhető fiókokról (próbaverziós és fizetős lehetőségekről) az Azure AI Video Indexer fióktípusairól olvashat.

Ez a cikk bemutatja, hogyan használhatja az Azure AI Video Indexer API-t.

Előfeltételek

Médiafájl feltöltése. Kétféleképpen lehet:

1. Töltsön fel egy médiafájlt a választott URL-címre (ajánlott). Nyilvános hálózati helyet is használhat. A fájl feltöltése után ellenőrizheti, hogy a fájl elérhető-e az AVI számára, ha másolja és beilleszti a böngésző helysávjába. Ha le tudja játszani a médiafájlt, akkor valószínű, hogy a VI is hozzáfér hozzá. Ha az Azure Storage Blob használatával szeretné biztonságossá tenni a tárolási helyet, töltse fel a fájlt, és szerezze be az SAS URL-címet. A fájl biztonságos URL-címének lekéréséről további információt az Azure Blob Storage SAS URL-címeiről talál. Ezzel az URL-címvel másolhatja a fájlt az Azure AI Video Indexerbe indexelés céljából.

2. Küldje el a videofájlt egy bájttömböt a kérelem törzsében. A médiafájl bájttömbként való feltöltéséről további információt a .NET-blob feltöltése című témakörben talál.

Feljegyzés

Az API-kérések száma másodpercenként 10, percenként legfeljebb 120 kérés lehet.

Feliratkozás az API-ra

Fontos

• Ugyanazt az e-mailt kell használnia, amelyet az Azure AI Video Indexerre való regisztrációkor használt.
• Személyes Google- és Microsoft-fiókok (Outlook/Live) csak próbaverziós fiókokhoz használhatók. Az Azure-hoz csatlakoztatott fiókokhoz Entra-azonosító szükséges.
• E-mailben csak egy aktív fiók lehet. Ha egy felhasználó megpróbál bejelentkezni user@gmail.com a LinkedInbe, majd később a user@gmail.com Google-ba, az utóbbi egy hibaoldalt jelenít meg, amely azt jelzi, hogy a felhasználó már létezik.
• A kulcsokat védeni kell. Csak a kiszolgálókód használhatja a kulcsokat. Nem lehetnek elérhetők az ügyféloldalon (.js, .html stb.).

1. Jelentkezzen be az Azure AI Video Indexer API fejlesztői portálra.
2. Feliratkozás a Termékek fülre kattintva. Ezután válassza az Engedélyezés lehetőséget, és iratkozzon fel. Az új felhasználók automatikusan feliratkoznak az Engedélyezési API-ra.
3. Keresse meg, másolja és mentse az elsődleges és másodlagos kulcsokat. Előfizetését a profiljában találja. Az elsődleges és másodlagos kulcsok az Előfizetések szakaszban találhatók.
4. Válassza az Elsődleges és a Másodlagos kulcs megjelenítési hivatkozását. Másolja és illessze be őket egy szövegszerkesztőbe, amíg készen nem áll a környezeti változók fájljában való használatra.

Hozzáférési jogkivonat beszerzése az Engedélyezési API használatával

Nem szeretne teljes hozzáférést biztosítani az alkalmazás minden felhasználójához. A VI-hez több hozzáférési szint is rendelkezésre áll.

Level	Videók megtekintése	Videók feldolgozása	Projektek megtekintése	Projektek feldolgozása	Fiókok megtekintése	Fiókok kezelése
Videóolvasó	✔️
Videó közreműködője	✔️	✔️
Projektolvasó	✔️		✔️
Projekt közreműködője	✔️	✔️	✔️	✔️
Fiókolvasó	✔️		✔️		✔️
Fiók közreműködője	✔️	✔️	✔️	✔️	✔️	✔️

A hozzáférési jogkivonat-kérelem létrehozása és elküldése

Állítsa be a subscription-idkérésben a , a resource-group-namevi, a vi account-name értéket, és állítsa scope a kérelem törzsében lévő paramétert permissionType a szükséges hozzáférési szintre.

Ha például hozzáférést szeretne biztosítani egy felhasználónak, hogy projekteket működhessen, de nem tud fiókokkal dolgozni, állítsa a permissionType "Közreműködő" és a scope "Projekt" értéket. Ha egy projekt engedélyeit állítja be, adja meg a 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"
}

Mintaválasz

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

További példák a hatókör és az engedélytípusok beállítására: VI REST API.

Az API használatának megkezdése

Készen áll az API használatára. Keresse meg az egyes Azure AI Video Indexer REST API-k részletes leírását.

A környezeti változófájl kulcsainak használatára és a hozzáférési jogkivonatok használatára vonatkozó részletes példát az Azure AI Video Indexer mintájában találja.

Ajánlások

• Amikor meghívja az adott videóhoz tartozó videóelemzéseket lekérő API-t, részletes JSON-kimenetet kap a válasz tartalmaként. A visszaadott JSON-ról ebben a cikkben olvashat.
• Az API által előállított JSON-kimenet tartalmazza Insights és SummarizedInsights tartalmazza az elemeket. Javasoljuk, hogy használja Insights és ne használja SummarizedInsights (ami a visszamenőleges kompatibilitás érdekében jelen van).
• Nem javasoljuk, hogy éles környezetben közvetlenül az összetevők mappájából származó adatokat használja. Az összetevők az indexelési folyamat köztes kimenetei, és a videókat elemző különböző AI-motorok nyers kimenetei. Az összetevők sémája idővel változhat.
• Használja a Get Video Index API-t az APIáltal létrehozott Betekintő elemzések és összetevők lekérése és nema Get-Video-Artifact-Download-URL-cím leírásában leírtak szerint.