Rychlý start: Použití rozhraní API

  • Článek

Důležité

Vzhledem k oznámení o vyřazení služby Azure Media Services vám Azure AI Video Indexer oznámí úpravy funkcí Azure AI Video Indexeru. Informace o tom, co to znamená pro váš účet Azure AI Video Indexer, najdete v tématu Změny související s vyřazením služby Azure Media Service (AMS). Podívejte se na průvodce přípravou na vyřazení AMS: Průvodce aktualizací VI a migrací.

Azure AI Video Indexer konsoliduje různé technologie umělé inteligence (AI) zvuku a videa, které Microsoft nabízí, do jedné integrované služby a zjednodušuje vývoj. Azure AI Video Indexer je navržený tak, aby vývojářům umožnil soustředit se na používání technologií umělé inteligence médií, aniž by se museli starat o škálování, globální dosah, dostupnost a spolehlivost cloudových platforem. Rozhraní API můžete použít k nahrání souborů, získání podrobných přehledů videa, získání adres URL vložených přehledů, widgetů přehrávače a dalších možností.

Když poprvé navštívíte web Azure AI Video Indexeru , automaticky se pro vás vytvoří zkušební účet. Se zkušebním účtem získáte několik bezplatných minut indexování. Později můžete přidat placený účet. S placenou možností platíte za indexované minuty. Podrobnosti o dostupných účtech (zkušební a placené možnosti) najdete v typech účtů Azure AI Video Indexeru.

V tomto článku se dozvíte, jak používat rozhraní API služby Azure AI Video Indexer.

Požadavky

Nahrajte multimediální soubor. Existují dva způsoby:

  1. Nahrajte multimediální soubor na adresu URL podle vašeho výběru (doporučeno). Můžete použít veřejné síťové umístění. Po nahrání souboru můžete zkontrolovat, jestli je soubor přístupný pro AVI, a to tak, že ho zkopírujete a vložíte do panelu umístění prohlížeče. Pokud můžete multimediální soubor přehrát, je pravděpodobné, že k němu bude mít přístup i VI. Pokud chcete zabezpečit umístění úložiště pomocí objektu blob služby Azure Storage, nahrajte soubor a získejte adresu URL SAS. Další informace o získání zabezpečené adresy URL pro soubor najdete v tématu Adresy URL SAS služby Azure Blob Storage. Tato adresa URL slouží ke zkopírování souboru do Azure AI Video Indexeru pro indexování.

  2. Odešle videosoubor pole bajtů v textu požadavku. Další informace o nahrání multimediálního souboru jako pole bajtů v textu požadavku najdete v tématu Nahrání objektu blob pomocí .NET.

Poznámka:

Limit požadavků rozhraní API je 10 požadavků za sekundu a až 120 požadavků za minutu.

Přihlášení k odběru rozhraní API

Důležité

  • Musíte použít stejný e-mail, který jste použili při registraci k Azure AI Video Indexeru.
  • Osobní účty Google a Microsoft (Outlook/Live) se dají používat jenom pro zkušební účty. Účty připojené k Azure vyžadují ID Entra.
  • Každý e-mail může obsahovat jenom jeden aktivní účet. Pokud se uživatel pokusí přihlásit user@gmail.com k LinkedInu a později s googlem user@gmail.com , zobrazí se chybová stránka s informací, že uživatel už existuje.
  • Klíče by měly být chráněné. Klíče by měl používat jenom kód vašeho serveru. Neměly by být dostupné na straně klienta (.js, .html atd.).
  1. Přihlaste se k portálu pro vývojáře rozhraní API služby Azure AI Video Indexer.
  2. Přihlaste se k odběruvýběrem karty Produkty . Pak vyberte Autorizace a přihlásit se k odběru. Noví uživatelé jsou k odběru API Authorization automaticky přihlášení.
  3. Vyhledejte, zkopírujte a uložte primární a sekundární klíče. Svoje předplatné najdete ve svém profilu. Primární a sekundární klíče jsou v části Předplatná .
  4. Vyberte odkaz Zobrazit pro primární i sekundární klíč. Zkopírujte je a vložte do textového editoru, dokud nebudete připraveni je použít v souboru proměnných prostředí.

Získání přístupového tokenu pomocí autorizačního rozhraní API

Nechcete udělit úplný přístup každému uživateli pro vaši aplikaci. Pro VI existuje několik úrovní přístupu.

Level Zobrazení videí Zpracování videí Zobrazit projekty Zpracování projektů Zobrazení účtů Správa účtů
Čtečka videa ✔️
Přispěvatel videa ✔️ ✔️
Čtenář projektu ✔️ ✔️
Přispěvatel projektu ✔️ ✔️ ✔️ ✔️
Čtenář účtu ✔️ ✔️ ✔️
Přispěvatel účtu ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Vytvoření a odeslání žádosti o přístupový token

subscription-idNastavte v požadavku VI account-name a resource-group-namev textu požadavku nastavte parametr a permissionType nastavte scope úroveň přístupu, kterou potřebujete.

Pokud například chcete uživateli poskytnout přístup, aby mohl pracovat s projekty, ale nemůže pracovat s účty, nastavte permissionType hodnotu Přispěvatel a scope Projekt. POKUD nastavuje oprávnění pro projekt, zadejte 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"
}

Ukázková odpověď

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

Další příklady nastavení rozsahu a typů oprávnění najdete v rozhraní REST API VI.

Začněte používat rozhraní API

Jste připraveni začít používat rozhraní API. Vyhledejte podrobný popis jednotlivých rozhraní REST API služby Azure AI Video Indexer.

Podrobný příklad použití klíčů v souboru proměnné prostředí a použití přístupových tokenů najdete v ukázce Azure AI Video Indexeru.

Doporučení