Share via

Snabbstart: Använda API:et

  • Artikel

Viktigt!

På grund av azure Media Services-tillbakadragandemeddelandet meddelar Azure AI Video Indexer att funktionsjusteringar för Azure AI Video Indexer har justerats. Mer information om vad detta innebär för ditt Azure AI Video Indexer-konto finns i Ändringar som rör tillbakadragning av Azure Media Service (AMS). Se guiden Förbereda för AMS-pensionering: VI-uppdatering och migrering.

Azure AI Video Indexer konsoliderar olika tekniker för artificiell intelligens (AI) för ljud och video som erbjuds av Microsoft till en integrerad tjänst, vilket gör utvecklingen enklare. Azure AI Video Indexer är utformat för att göra det möjligt för utvecklare att fokusera på att använda ai-tekniker i media utan att behöva oroa sig för skalning, global räckvidd, tillgänglighet och tillförlitlighet för molnplattformar. Du kan använda API:et för att ladda upp dina filer, få detaljerade videoinsikter, hämta URL:er för inbäddningsbara insikter, spelarwidgetar med mera.

När du besöker Azure AI Video Indexer-webbplatsen för första gången skapas ett utvärderingskonto automatiskt åt dig. Med utvärderingskontot får du några kostnadsfria indexeringsminuter. Du kan senare lägga till ett betalt konto. Med det betalda alternativet betalar du för indexerade minuter. Mer information om tillgängliga konton (utvärderingsalternativ och betalda alternativ) finns i Kontotyper för Azure AI Video Indexer.

Den här artikeln visar hur du använder Api:et för Azure AI Video Indexer.

Förutsättningar

Ladda upp en mediefil. Det finns två sätt:

  1. Ladda upp en mediefil till valfri URL (rekommenderas). Du kan använda en offentlig nätverksplats. När du har laddat upp filen kan du kontrollera om filen är tillgänglig för AVI genom att kopiera och klistra in den i webbläsarens platsfält. Om du kan spela upp mediefilen är det troligt att VI också kan komma åt den. Om du vill skydda lagringsplatsen med Hjälp av Azure Storage Blob laddar du upp filen och hämtar en SAS-URL. Mer information om hur du hämtar en säker URL för din fil finns i AZURE Blob Storage SAS-URL:er. Den här URL:en används för att kopiera filen till Azure AI Video Indexer för indexering.

  2. Skicka videofilen till en bytematris i begärandetexten. Mer information om hur du laddar upp en mediefil som en bytematris i en begärandetext finns i Ladda upp en blob med .NET.

Kommentar

Det finns en API-begärandegräns på 10 begäranden per sekund och upp till 120 begäranden per minut.

Prenumerera på API:et

Viktigt!

  • Du måste använda samma e-post som du använde när du registrerade dig för Azure AI Video Indexer.
  • Personliga Google- och Microsoft-konton (Outlook/Live) kan bara användas för utvärderingskonton. Konton som är anslutna till Azure kräver Etttra-ID.
  • Det kan bara finnas ett aktivt konto per e-post. Om en användare försöker logga in med user@gmail.com för LinkedIn och senare med user@gmail.com för Google visar den senare en felsida som säger att användaren redan finns.
  • Nycklar ska skyddas. Nycklarna ska bara användas av din serverkod. De bör inte vara tillgängliga på klientsidan (.js, .html och så vidare).
  1. Logga in på utvecklarportalen för Azure AI Video Indexer API.
  2. Prenumerera genom att välja fliken Produkter . Välj sedan Auktorisering och prenumerera. Nya användare prenumererar automatiskt på Auktorisering.
  3. Hitta, kopiera och spara de primära och sekundära nycklarna. Du hittar din prenumeration i din profil. De primära och sekundära nycklarna finns i avsnittet Prenumerationer .
  4. Välj länken Visa för både primärnyckeln och sekundärnyckeln. Kopiera och klistra in dem i en textredigerare tills du är redo att använda dem i miljövariabelfilen.

Hämta en åtkomsttoken med hjälp av auktoriserings-API:et

Du vill inte ge fullständig åtkomst till alla användare för ditt program. Det finns flera åtkomstnivåer för VI.

Nivå Visa videor Bearbeta videor Visa projekt Bearbeta projekt Visa konton Hantera konton
Videoläsare ✔️
Videodeltagare ✔️ ✔️
Projektläsare ✔️ ✔️
Projektdeltagare ✔️ ✔️ ✔️ ✔️
Kontoläsare ✔️ ✔️ ✔️
Kontodeltagare ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Skapa och skicka begäran om åtkomsttoken

subscription-idAnge , , resource-group-nameVI account-name i begäran och ange parametern scope och permissionType i begärandetexten till den åtkomstnivå du behöver.

Om du till exempel vill ge åtkomst till en användare så att de kan arbeta med projekt men inte kan arbeta med konton anger du permissionType till "Deltagare" och scope till "Projekt". Om du anger behörigheter för ett projekt anger du 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"
}

Exempelsvar

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

Fler exempel på hur du anger omfångs- och behörighetstyper finns i VI REST API.

Börja använda API

Du är redo att börja använda API:et. Hitta den detaljerade beskrivningen av varje REST API för Azure AI Video Indexer.

Ett detaljerat exempel på hur du använder nycklarna i miljövariabelfilen och hur du använder åtkomsttoken finns i Azure AI Video Indexer-exemplet.

Rekommendationer