Delen via

Quickstart: De API gebruiken

  • Artikel

Belangrijk

Vanwege de aankondiging van buitengebruikstelling van Azure Media Services kondigt Azure AI Video Indexer-functies aan. Zie Wijzigingen met betrekking tot buitengebruikstelling van Azure Media Service (AMS) om te begrijpen wat dit betekent voor uw Azure AI Video Indexer-account. Zie de handleiding voorbereiden voor AMS-buitengebruikstelling: VI-update en migratiehandleiding.

Azure AI Video Indexer consolideert verschillende ai-technologieën (audio- en video artificial intelligence) die door Microsoft worden aangeboden in één geïntegreerde service, waardoor ontwikkeling eenvoudiger wordt. Azure AI Video Indexer is ontworpen om ontwikkelaars in staat te stellen zich te richten op het gebruik van AI-technologieën voor media zonder dat ze zich zorgen hoeven te maken over schaal, wereldwijd bereik, beschikbaarheid en betrouwbaarheid van cloudplatforms. U kunt de API gebruiken om uw bestanden te uploaden, gedetailleerde video-inzichten te verkrijgen, URL's van ingesloten inzichten, spelerwidgets en meer op te halen.

Wanneer u de Azure AI Video Indexer-website voor het eerst bezoekt, wordt er automatisch een proefaccount voor u gemaakt. Met het proefaccount krijgt u enkele gratis indexeringsminuten. U kunt later een betaald account toevoegen. Met de betaalde optie betaalt u voor geïndexeerde minuten. Zie Azure AI Video Indexer-accounttypen voor meer informatie over beschikbare accounts (proef- en betaalde opties).

In dit artikel leest u hoe u de Azure AI Video Indexer-API gebruikt.

Vereisten

Een mediabestand uploaden. Er zijn twee manieren:

  1. Upload een mediabestand naar de URL van uw keuze (aanbevolen). U kunt een openbare netwerklocatie gebruiken. Nadat u het bestand hebt geüpload, kunt u controleren of het bestand toegankelijk is voor AVI door het te kopiëren en te plakken in de locatiebalk van uw browser. Als u het mediabestand kunt afspelen, is het waarschijnlijk dat VI er ook toegang toe heeft. Als u de opslaglocatie wilt beveiligen met behulp van Azure Storage Blob, uploadt u het bestand en verkrijgt u een SAS-URL. Zie SAS-URL's voor Azure Blob Storage voor meer informatie over het ophalen van een beveiligde URL voor uw bestand. Deze URL wordt gebruikt om uw bestand te kopiëren naar Azure AI Video Indexer voor indexering.

  2. Verzend het videobestand een bytematrix in de aanvraagbody. Zie Een blob uploaden met .NET voor meer informatie over het uploaden van een mediabestand als een bytematrix in een aanvraagbody.

Notitie

Er is een API-aanvraaglimiet van 10 aanvragen per seconde en maximaal 120 aanvragen per minuut.

Abonneren op de API

Belangrijk

  • U moet dezelfde e-mail gebruiken die u hebt gebruikt toen u zich registreerde voor Azure AI Video Indexer.
  • Persoonlijke Google- en Microsoft-accounts (Outlook/Live) kunnen alleen worden gebruikt voor proefaccounts. Accounts die zijn verbonden met Azure, vereisen Entra-id.
  • Er kan slechts één actief account per e-mail zijn. Als een gebruiker zich probeert aan te melden voor user@gmail.com LinkedIn en later met user@gmail.com Google, wordt er een foutpagina weergegeven met de mededeling dat de gebruiker al bestaat.
  • Sleutels moeten worden beveiligd. De sleutels mogen alleen door uw servercode gebruikt worden. Ze mogen niet beschikbaar zijn aan de clientzijde (.js, .html enzovoort).
  1. Meld u aan bij de Azure AI Video Indexer API-ontwikkelaarsportal.
  2. Abonneer u door het tabblad Producten te selecteren. Selecteer vervolgens Autorisatie en abonneer u. Nieuwe gebruikers worden automatisch geabonneerd op Autorisatie.
  3. Zoek, kopieer en sla de primaire en secundaire sleutels op. U vindt uw abonnement in uw profiel. De primaire en secundaire sleutels bevinden zich in de sectie Abonnementen .
  4. Selecteer de koppeling Weergeven voor zowel de primaire sleutel als de secundaire sleutel. Kopieer en plak ze in een teksteditor totdat u ze in het bestand met omgevingsvariabelen kunt gebruiken.

Een toegangstoken verkrijgen met behulp van de Autorisatie-API

U wilt niet alle gebruikers voor uw toepassing volledige toegang geven. Er zijn verschillende toegangsniveaus voor VI.

Niveau Video's weergeven Video's verwerken Projecten weergeven Procesprojecten Accounts weergeven Accounts beheren
Videolezer ✔️
Videobijdrager ✔️ ✔️
Projectlezer ✔️ ✔️
Projectbijdrager ✔️ ✔️ ✔️ ✔️
Accountlezer ✔️ ✔️ ✔️
Accountbijdrager ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

De toegangstokenaanvraag maken en verzenden

Stel de subscription-id, de resource-group-nameVI account-name in de aanvraag in en stel de scope en permissionType parameter in de aanvraagbody in op het gewenste toegangsniveau.

Als u bijvoorbeeld toegang wilt verlenen tot een gebruiker, zodat deze met projecten kan werken, maar niet met accounts kan werken, stelt u de permissionType optie Inzender en scope Project in. Als u machtigingen voor een project instelt, geeft u het 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"
}

Voorbeeldrespons

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

Zie de VI REST API voor meer voorbeelden van het instellen van het bereik en de machtigingstypen.

Begin de API te gebruiken

U bent klaar om de API te gaan gebruiken. Zoek de gedetailleerde beschrijving van elke Azure AI Video Indexer REST API.

Zie het Voorbeeld van Azure AI Video Indexer voor een gedetailleerd voorbeeld van het gebruik van de sleutels in uw omgevingsvariabelebestand en het gebruik van toegangstokens.

Aanbevelingen

  • Als u de API die video-inzichten ophaalt voor de opgegeven video aanroept, krijgt u gedetailleerde JSON-uitvoer als resultaat. In dit artikel vindt u meer informatie over de geretourneerde JSON.
  • De JSON-uitvoer die door de API wordt geproduceerd, bevat Insights en SummarizedInsights elementen. We raden u ten zeerste aan gebruik te maken Insights en niet te gebruiken SummarizedInsights (die aanwezig is voor achterwaartse compatibiliteit).
  • Het is niet raadzaam om gegevens rechtstreeks uit de map artefacten te gebruiken voor productiedoeleinden. Artefacten zijn tussenliggende uitvoer van het indexeringsproces en zijn onbewerkte uitvoer van de verschillende AI-engines die de video's analyseren. Het schema voor artefacten kan na verloop van tijd worden gewijzigd.
  • Gebruik de Get Video Index-API , zoals beschreven in Inzichten en artefacten ophalen die worden geproduceerd door de API en nietGet-Video-Artifact-Download-URL.