Guida introduttiva: Usare l'API

Importante

A causa dell'annuncio di ritiro Servizi multimediali di Azure, Azure AI Video Indexer annuncia le modifiche alle funzionalità di Azure AI Video Indexer. Vedere Modifiche correlate al ritiro di Servizi multimediali di Azure (AMS) per comprendere cosa significa per l'account Video Indexer di Azure per intelligenza artificiale. Vedere la guida alla preparazione per il ritiro di AMS: aggiornamento VI e migrazione.

Azure AI Video Indexer consolida varie tecnologie di intelligenza artificiale audio e video offerte da Microsoft in un unico servizio integrato, semplificando lo sviluppo. Video Indexer di Azure per intelligenza artificiale è progettato per consentire agli sviluppatori di concentrarsi sull'uso delle tecnologie di intelligenza artificiale multimediale senza doversi preoccupare della scalabilità, della copertura globale, della disponibilità e dell'affidabilità delle piattaforme cloud. È possibile usare l'API per caricare i file, ottenere informazioni dettagliate sui video, ottenere URL di informazioni dettagliate incorporabili, widget lettore e altro ancora.

Quando si visita il sito Web di Azure AI Video Indexer per la prima volta, viene creato automaticamente un account di valutazione. Con l'account di valutazione si ottengono alcuni minuti di indicizzazione gratuiti. In seguito è possibile aggiungere un account a pagamento. Con l'opzione a pagamento, si paga per i minuti indicizzati. Per informazioni dettagliate sugli account disponibili (opzioni di valutazione e a pagamento), vedere Tipi di account di Azure AI Video Indexer.

Questo articolo illustra come usare l'API Video Indexer di Intelligenza artificiale di Azure.

Prerequisiti

Caricare un file multimediale. Esistono due modi:

1. Caricare un file multimediale nell'URL preferito (scelta consigliata). È possibile usare un percorso di rete pubblico. Dopo aver caricato il file, è possibile verificare se il file è accessibile a AVI copiandolo e incollandolo nella barra dei percorsi del browser. Se è possibile riprodurre il file multimediale, è probabile che vi possa accedervi. Se si vuole proteggere il percorso di archiviazione usando Archiviazione di Azure BLOB, caricare il file e ottenere un URL di firma di accesso condiviso. Per altre informazioni su come ottenere un URL sicuro per il file, vedere Archiviazione BLOB di Azure URL di firma di accesso condiviso. Questo URL viene usato per copiare il file in Azure AI Video Indexer per l'indicizzazione.

2. Inviare il file video a una matrice di byte nel corpo della richiesta. Per altre informazioni sul caricamento di un file multimediale come matrice di byte in un corpo della richiesta, vedere Caricare un BLOB con .NET.

Nota

Esiste un limite di richieste API di 10 richieste al secondo e fino a 120 richieste al minuto.

Eseguire la sottoscrizione all'API

Importante

• È necessario usare lo stesso messaggio di posta elettronica usato quando si è iscritti ad Azure AI Video Indexer.
• Gli account Google e Microsoft personali (Outlook/Live) possono essere usati solo per gli account di valutazione. Gli account connessi ad Azure richiedono l'ID Entra.
• Può essere presente un solo account attivo per ogni indirizzo di posta elettronica. Se un utente cerca di effettuare l'accesso con user@gmail.com per LinkedIn e successivamente con user@gmail.com per Google, verrà visualizzata una pagina di errore che indica che l'utente esiste già.
• Le chiavi devono essere protette. Le chiavi devono essere usate solo dal codice server. Non devono essere disponibili sul lato client (JS, HTML e così via).

1. Accedere al portale per sviluppatori dell'API video indexer di Azure per intelligenza artificiale.
2. Sottoscrivere selezionando la scheda Prodotti . Selezionare quindi Autorizzazione e sottoscrizione. I nuovi utenti sono automaticamente sottoscritti per l'autorizzazione.
3. Trovare, copiare e salvare le chiavi primarie e secondarie. È possibile trovare la sottoscrizione nel profilo. Le chiavi primarie e secondarie si trovano nella sezione Sottoscrizioni .
4. Selezionare il collegamento Mostra sia per la chiave primaria che per la chiave secondaria. Copiarli e incollarli in un editor di testo fino a quando non si è pronti per usarli nel file delle variabili di ambiente.

Ottenere un token di accesso usando l'API di autorizzazione

Non si vuole concedere l'accesso completo a ogni utente per l'applicazione. Esistono diversi livelli di accesso per VI.

Livello	Visualizzare video	Elaborare i video	Visualizzare i progetti	Elaborare progetti	Visualizzare gli account	Gestione degli account
Lettore video	✔️
Collaboratore video	✔️	✔️
Lettore di progetti	✔️		✔️
Collaboratore progetto	✔️	✔️	✔️	✔️
Lettore account	✔️		✔️		✔️
Collaboratore account	✔️	✔️	✔️	✔️	✔️	✔️

Creare e inviare la richiesta di token di accesso

subscription-idImpostare , , resource-group-nameil VI account-name nella richiesta e impostare il scope parametro e permissionType nel corpo della richiesta sul livello di accesso necessario.

Ad esempio, se si vuole fornire l'accesso a un utente in modo che possa lavorare con i progetti, ma non può funzionare con gli account, impostare su permissionType "Collaboratore" e su scope "Progetto". Se si impostano le autorizzazioni per un progetto, specificare .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"
}

Risposta di esempio

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

Per altri esempi di impostazione dell'ambito e dei tipi di autorizzazione, vedere l'API REST VI.

Inizia a usare l'API

Si è pronti per iniziare a usare l'API. Trovare la descrizione dettagliata di ogni API REST di Video Indexer per intelligenza artificiale di Azure.

Per un esempio dettagliato dell'uso delle chiavi nel file delle variabili di ambiente e dell'uso dei token di accesso, vedere l'esempio di Video Indexer di Intelligenza artificiale di Azure.

Consigli

• Quando si chiama l'API che consente di ottenere informazioni dettagliate sui video per il video specificato, viene visualizzato un output JSON dettagliato come contenuto della risposta. Vedere i dettagli sul codice JSON restituito in questo articolo.
• L'output JSON prodotto dall'API contiene Insights elementi e SummarizedInsights . È consigliabile usare e non usare InsightsSummarizedInsights (che è presente per la compatibilità con le versioni precedenti).
• Non è consigliabile usare i dati direttamente dalla cartella artefatti a scopo di produzione. Gli artefatti sono output intermedi del processo di indicizzazione e sono output non elaborati dei vari motori di intelligenza artificiale che analizzano i video. Lo schema degli artefatti può cambiare nel tempo.
• Usare l'API Get Video Index , come descritto in Ottenere informazioni dettagliate e artefatti prodotti dall'API e nonGet-Video-Artifact-Download-Url.