Schnellstart: Verwenden der API

Wichtig

Aufgrund der Ankündigung zur Einstellung von Azure Media Services kündigt Azure AI Video Indexer Anpassungen an. Siehe Änderungen im Zusammenhang mit der Einstellung von Azure Media Service (AMS), um zu verstehen, was dies für Ihr Azure AI Video Indexer-Konto bedeutet. Weitere Informationen finden Sie im Leitfaden zur Vorbereitung auf die Einstellung von AMS: VI-Update und -Migration.

Azure KI Video Indexer fasst verschiedene von Microsoft angebotene Technologien für künstliche Intelligenz (KI) im Audio- und Videobereich in einem einzigen integrierten Dienst zusammen und vereinfacht so die Entwicklung. Azure AI Video Indexer ist so konzipiert, dass Entwickler sich auf die Verwendung von Medien-KI-Technologien konzentrieren können, ohne sich gedanken über Skalierung, globale Reichweite, Verfügbarkeit und Zuverlässigkeit von Cloudplattformen zu machen. Sie können die API verwenden, um Ihre Dateien hochzuladen, detaillierte Videoeinblicke zu erhalten, URLs von einbettbaren Insights, Player-Widgets und mehr abzurufen.

Wenn Sie die Azure KI Video Indexer-Website zum ersten Mal besuchen, wird automatisch ein Testkonto für Sie erstellt. Mit dem Testkonto erhalten Sie einige kostenlose Indizierungsminuten. Sie können später ein kostenpflichtiges Konto hinzufügen. Bei der kostenpflichtigen Option bezahlen Sie für indizierte Minuten. Ausführliche Informationen zu verfügbaren Konten (kostenlose Testoptionen und kostenpflichtige Optionen) finden Sie unter Azure KI Video Indexer-Kontotypen.

In diesem Artikel erfahren Sie, wie Sie die Azure AI Video Indexer-API verwenden.

Voraussetzungen

Laden Sie eine Mediendatei hoch. Es gibt zwei Methoden:

1. Laden Sie eine Mediendatei auf die URL Ihrer Wahl hoch (empfohlen). Sie können einen öffentlichen Netzwerkspeicherort verwenden. Nachdem Sie die Datei hochgeladen haben, können Sie überprüfen, ob die Datei auf AVI zugreifen kann, indem Sie sie in die Speicherortleiste Ihres Browsers kopieren und einfügen. Wenn Sie die Mediendatei wiedergeben können, ist es wahrscheinlich, dass VI auch darauf zugreifen kann. Wenn Sie den Speicherort mithilfe von Azure Storage Blob sichern möchten, laden Sie die Datei hoch, und rufen Sie eine SAS-URL ab. Weitere Informationen zum Abrufen einer sicheren URL für Ihre Datei finden Sie unter Azure Blob Storage SAS-URLs. Diese URL wird verwendet, um Ihre Datei zum Indizieren in Azure AI Video Indexer zu kopieren.

2. Senden Sie die Videodatei an ein Bytearray im Anforderungstext. Weitere Informationen zum Hochladen einer Mediendatei als Bytearray in einem Anforderungstext finden Sie unter Hochladen eines BLOB mit .NET.

Hinweis

Es gibt ein API-Anforderungslimit von zehn Anforderungen pro Sekunde und bis zu 120 Anforderungen pro Minute.

Abonnieren der API

Wichtig

• Sie müssen dieselbe E-Mail verwenden, die Sie bei der Registrierung für Azure AI Video Indexer verwendet haben.
• Persönliche Google- und Microsoft-Konten (Outlook/Live) können nur für Testkonten verwendet werden. Mit Azure verbundene Konten erfordern entra-ID.
• Pro E-Mail-Adresse kann nur ein aktives Konto vorhanden sein. Wenn ein Benutzer versucht, sich mit user@gmail.com für LinkedIn anzumelden, und später user@gmail.com auch für Google verwendet, wird für die zweite Anmeldung eine Fehlerseite mit dem Hinweis angezeigt, dass der Benutzer bereits vorhanden ist.
• Schlüssel sollten geschützt werden. Die Schlüssel sollten nur von Ihrem Servercode verwendet werden. Sie sollten nicht auf Clientseite (.js, .html usw.) verfügbar sein.

1. Melden Sie sich beim Entwicklerportal der Azure AI Video Indexer-API an.
2. Abonnieren Sie , indem Sie die Registerkarte "Produkte " auswählen. Wählen Sie dann "Autorisierung" und "Abonnieren" aus. Für neue Benutzer wird das Abonnement der Autorisierung automatisch eingerichtet.
3. Suchen, Kopieren und Speichern der primären und sekundären Schlüssel. Sie finden Ihr Abonnement in Ihrem Profil. Die primären und sekundären Schlüssel befinden sich im Abschnitt "Abonnements ".
4. Wählen Sie den Link "Anzeigen" für den Primärschlüssel und den Sekundärschlüssel aus. Kopieren Sie sie, und fügen Sie sie in einen Text-Editor ein, bis Sie bereit sind, sie in ihrer Umgebungsvariablendatei zu verwenden.

Abrufen eines Zugriffstokens mithilfe der Autorisierungs-API

Sie möchten nicht jedem Benutzer für Ihre Anwendung Vollzugriff gewähren. Es gibt mehrere Zugriffsebenen für VI.

Ebene	Videos anzeigen	Verarbeiten von Videos	Projekte anzeigen	Prozessprojekte	Konten anzeigen	Konten verwalten
Videosprachausgabe	✔️
Videomitwirkender	✔️	✔️
Projektleser	✔️		✔️
Projektmitwirkender	✔️	✔️	✔️	✔️
Kontoleser	✔️		✔️		✔️
Kontomitwirkender	✔️	✔️	✔️	✔️	✔️	✔️

Erstellen und Senden der Zugriffstokenanforderung

Legen Sie die subscription-id, die resource-group-nameVI account-name in der Anforderung und den scope Parameter permissionType im Anforderungstext auf die benötigte Zugriffsebene fest.

Wenn Sie z. B. Zugriff auf einen Benutzer gewähren möchten, damit er mit Projekten arbeiten kann, aber nicht mit Konten arbeiten kann, legen Sie " permissionType Mitwirkender" und " scope Projekt" fest. Wenn Sie Berechtigungen für ein Projekt festlegen, geben Sie die 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"
}

Beispiel für eine Antwort

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

Weitere Beispiele zum Festlegen des Bereichs und der Berechtigungstypen finden Sie in der VI-REST-API.

Mit der Verwendung der API beginnen

Sie können mit der Verwendung der API beginnen. Lesen Sie sich die ausführliche Beschreibung zu den einzelnen Azure KI Video Indexer-REST-API durch.

Ein detailliertes Beispiel für die Verwendung der Schlüssel in ihrer Umgebungsvariablendatei und die Verwendung von Zugriffstoken finden Sie im Azure AI Video Indexer-Beispiel.

Empfehlungen

• Wenn Sie die API aufrufen, mit der Videoinformationen für das angegebene Video abgerufen werden, erhalten Sie eine ausführliche JSON-Ausgabe als Inhalt der Antwort. Lesen Sie die Details zum zurückgegebenen JSON-Code in diesem Artikel.
• Die von der API erstellte JSON-Ausgabe enthält die Elemente Insights und SummarizedInsights. Es wird dringend empfohlen, Insights anstelle von SummarizedInsights zu verwenden (das für die Abwärtskompatibilität vorhanden ist).
• Es wird nicht empfohlen, Daten direkt aus dem Ordner „Artefakte“ für Produktionszwecke zu verwenden. Artefakte sind Zwischenausgaben des Indizierungsprozesses und sind rohe Ausgaben der verschiedenen KI-Engines, die die Videos analysieren. Das Artefaktschema kann sich im Laufe der Zeit ändern.
• Verwenden Sie die "Videoindex-API abrufen", wie in "Abrufen von Erkenntnissen und Artefakten", die von der API erstellt wurden, und nicht"Get-Video-Artifact-Download-URL".