Personalizzare un modello Person con l'API Video Indexer di Intelligenza artificiale di Azure

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.

Nota

L'accesso alle funzionalità di identificazione, personalizzazione e riconoscimento delle celebrità è limitato in base ai criteri di idoneità e utilizzo per supportare i principi di IA responsabile. Le funzionalità di identificazione, personalizzazione e riconoscimento delle celebrità sono disponibili solo per i clienti e i partner gestiti da Microsoft. Usare il modulo di assunzione riconoscimento del viso per richiedere l'accesso.

Video Indexer di Azure per intelligenza artificiale supporta il rilevamento dei volti e il riconoscimento delle celebrità per il contenuto video. La funzionalità di riconoscimento delle celebrità copre circa un milione di visi basati su origini dati comunemente richieste, ad esempio IMDB, Wikipedia e principali influencer LinkedIn. I visi non riconosciuti dalla funzionalità di riconoscimento delle celebrità vengono rilevati ma non denominati. Dopo aver caricato il video in Azure AI Video Indexer e aver restituito i risultati, è possibile tornare indietro e denominare i visi non riconosciuti. Dopo aver etichettato un viso con un nome, il viso e il nome vengono aggiunti al modello delle persone del proprio account. Video Indexer di Azure per intelligenza artificiale riconoscerà quindi questo viso nei video futuri e nei video passati.

È possibile usare l'API Azure AI Video Indexer per modificare i visi rilevati in un video, come descritto in questo argomento. È anche possibile usare il sito Web di Azure AI Video Indexer, come descritto in Personalizzare il modello persona usando il sito Web di Azure AI Video Indexer.

Gestire più modelli Persona

Video Indexer di Intelligenza artificiale di Azure supporta più modelli person per account. Questa funzionalità è attualmente disponibile solo tramite le API video indexer di Intelligenza artificiale di Azure.

Se l'account si occupa di scenari di casi d'uso diversi, può essere preferibile creare più modelli Persona per account. Ad esempio, se il contenuto è correlato allo sport, è possibile creare un modello Person separato per ogni sport (calcio, basket, calcio e così via).

Dopo aver creato un modello, è possibile usarlo specificando l'ID modello di un modello Persona specifico quando si carica un video o lo si indicizza una o più volte. L'esecuzione del training di un nuovo viso per un video aggiorna il modello personalizzato specifico a cui è associato il viso.

Ogni account prevede un limite di 50 modelli Persona. Se non è necessario il supporto per più modelli Person, non assegnare un ID modello Person al video durante il caricamento/indicizzazione o la reindicizzazione. In questo caso, Azure AI Video Indexer usa il modello person personalizzato predefinito nell'account.

Creare un nuovo modello Persona

Per creare un nuovo modello Person nell'account specificato, usare l'API di creazione di un modello di persona.

La risposta specifica il nome e l'ID di modello generato del modello Persona che è stato appena creato seguendo il formato dell'esempio riportato di seguito.

{
    "id": "227654b4-912c-4b92-ba4f-641d488e3720",
    "name": "Example Person Model"
}

Usare quindi il valore ID per il parametro personModelId durante il caricamento di un video nell'indice o nella reindicizzazione di un video.

Eliminare un modello Persona

Per eliminare un modello Person personalizzato dall'account specificato, usare l'API di eliminazione di un modello di persona.

Dopo che il modello Persona è stato eliminato, l'indice dei video correnti che usavano tale modello rimane invariato fino alla reindicizzazione. Dopo la reindicizzazione, i visi denominati nel modello eliminato non verranno riconosciuti da Azure AI Video Indexer nei video correnti indicizzati usando tale modello, ma i visi verranno comunque rilevati. I video correnti che sono stati indicizzati usando il modello eliminato useranno il modello Persona predefinito dell'account. Se i visi presenti nel modello eliminato sono denominati anche nel modello predefinito dell'account, continueranno a essere riconosciuti nei video.

Non viene restituito alcun contenuto quando il modello Person viene eliminato correttamente.

Ottenere tutti i modelli Persona

Per ottenere tutti i modelli Person nell'account specificato, usare l'API get a person model ( Ottenere un modello di persona).

La risposta fornisce un elenco di tutti i modelli Person nell'account (incluso il modello Person predefinito nell'account specificato) e ognuno dei relativi nomi e ID seguendo il formato dell'esempio seguente.

[
    {
        "id": "59f9c326-b141-4515-abe7-7d822518571f",
        "name": "Default"
    }, 
    {
        "id": "9ef2632d-310a-4510-92e1-cc70ae0230d4",
        "name": "Test"
    }
]

È possibile scegliere il modello da usare per un video usando il id valore del modello Person per il parametro durante il personModelId caricamento di un video nell'indice o nella reindicizzazione di un video.

Aggiornare un viso

Questo comando consente di aggiornare un viso nel video con un nome usando l'ID del video e l'ID del viso. Questa azione aggiorna quindi il modello Person a cui è stato associato il video durante il caricamento/indicizzazione o la reindicizzazione. Se non è stato assegnato alcun modello Persona, il comando aggiorna il modello Persona predefinito dell'account.

Il sistema riconosce quindi le occorrenze dello stesso viso negli altri video correnti che condividono lo stesso modello Person. L'identificazione del viso negli altri video attuali può richiedere alcuni minuti poiché si tratta di un processo batch.

È possibile aggiornare un viso riconosciuto da Video Indexer per intelligenza artificiale di Azure come celebrità con un nuovo nome. Il nuovo nome assegnato avrà la precedenza sull'identificazione di celebrità predefinita.

Per aggiornare il viso, usare l'API aggiorna un viso video.

I nomi sono univoci per i modelli Person, quindi se si assegnano due visi diversi nello stesso modello Person lo stesso name valore del parametro, Azure AI Video Indexer visualizza i visi della stessa persona e li converge dopo aver reindicizzato il video.