Rychlý start: Použití rozhraní API
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:
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í.
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.).
- Přihlaste se k portálu pro vývojáře rozhraní API služby Azure AI Video Indexer.
- 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í.
- 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á .
- 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-id
Nastavte v požadavku VI account-name
a resource-group-name
v 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í
- Při volání rozhraní API, které získává přehledy ze zadaného videa získáte jako obsah odpovědi podrobný výstup JSON. Podrobnosti o vrácených json najdete v tomto článku.
- Výstup JSON vytvořený rozhraním API obsahuje
Insights
aSummarizedInsights
prvky. Důrazně doporučujeme používat a nepouInsights
postupovatSummarizedInsights
(což je k zajištění zpětné kompatibility). - Nedoporučujeme používat data přímo ze složky artefaktů pro produkční účely. Artefakty jsou přechodné výstupy procesu indexování a jsou nezpracované výstupy různých modulů AI, které analyzují videa. Schéma artefaktů se může v průběhu času měnit.
- Použijte rozhraní API Get Video Index, jak je popsáno v tématu Získání přehledů a artefaktů vytvořených rozhraním API, a neGet-Video-Artifact-Download-Url.
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro