Anpassa en personmodell med Azure AI Video Indexer API

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.

Kommentar

Åtkomst till funktioner för ansiktsidentifiering, anpassning och kändisigenkänning är begränsad baserat på berättigande- och användningskriterier för att stödja våra principer för ansvarsfull AI. Funktioner för ansiktsidentifiering, anpassning och kändisigenkänning är endast tillgängliga för Microsofts hanterade kunder och partner. Använd formuläret ansiktsigenkänning för att ansöka om åtkomst.

Azure AI Video Indexer stöder ansiktsidentifiering och kändisigenkänning för videoinnehåll. Funktionen för kändisigenkänning täcker cirka en miljon ansikten baserat på vanligen begärda datakällor som IMDB, Wikipedia och de främsta LinkedIn-påverkarna. Ansikten som inte känns igen av funktionen för kändisigenkänning identifieras men lämnas namnlösa. När du har laddat upp videon till Azure AI Video Indexer och fått resultat tillbaka kan du gå tillbaka och namnge de ansikten som inte kändes igen. När du har märkt ett ansikte med ett namn läggs ansiktet och namnet till i ditt kontos personmodell. Azure AI Video Indexer kommer sedan att känna igen det här ansiktet i dina framtida videor och tidigare videor.

Du kan använda API:et för Azure AI Video Indexer för att redigera ansikten som har identifierats i en video, enligt beskrivningen i det här avsnittet. Du kan också använda Webbplatsen för Azure AI Video Indexer enligt beskrivningen i Anpassa personmodell med hjälp av Webbplatsen för Azure AI Video Indexer.

Hantera flera personmodeller

Azure AI Video Indexer stöder flera personmodeller per konto. Den här funktionen är för närvarande endast tillgänglig via API:erna för Azure AI Video Indexer.

Om ditt konto hanterar olika användningsfallsscenarier kanske du vill skapa flera personmodeller per konto. Om ditt innehåll till exempel är relaterat till sport kan du skapa en separat personmodell för varje sport (fotboll, basket, fotboll och så vidare).

När en modell har skapats kan du använda den genom att ange modell-ID:t för en specifik personmodell när du laddar upp/indexerar eller indexerar om en video. När du tränar ett nytt ansikte för en video uppdateras den specifika anpassade modellen som videon var associerad med.

Varje konto har en gräns på 50 personmodeller. Om du inte behöver stöd för flera personmodeller ska du inte tilldela ett personmodell-ID till videon vid uppladdning/indexering eller omindexering. I det här fallet använder Azure AI Video Indexer standardmodellen för anpassad person i ditt konto.

Skapa en ny personmodell

Om du vill skapa en ny personmodell i det angivna kontot använder du API:et skapa en personmodell .

Svaret innehåller namnet och det genererade modell-ID:t för den personmodell som du nyss skapade enligt formatet i exemplet nedan.

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

Sedan använder du id-värdet för parametern personModelId när du laddar upp en video för att indexera om eller indexera om en video.

Ta bort en personmodell

Om du vill ta bort en anpassad personmodell från det angivna kontot använder du API:et för att ta bort en personmodell .

När personmodellen har tagits bort förblir indexet för dina aktuella videor som använde den borttagna modellen oförändrat tills du indexerar om dem. Vid omindexering identifieras inte de ansikten som namngavs i den borttagna modellen av Azure AI Video Indexer i dina aktuella videor som indexerades med den modellen, men ansiktena identifieras fortfarande. Dina aktuella videor som indexerats med den borttagna modellen använder nu kontots standardmodell Person. Om ansikten från den borttagna modellen också namnges i ditt kontos standardmodell fortsätter dessa ansikten att identifieras i videorna.

Det finns inget returnerat innehåll när personmodellen har tagits bort.

Hämta alla personmodeller

Om du vill hämta alla personmodeller i det angivna kontot använder du API:et hämta en personmodell .

Svaret innehåller en lista över alla personmodeller i ditt konto (inklusive standardmodellen Person i det angivna kontot) och vart och ett av deras namn och ID:n enligt formatet i exemplet nedan.

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

Du kan välja vilken modell du vill använda för en video genom att använda id värdet för personmodellen för parametern personModelId när du laddar upp en video för att indexera eller indexera om en video.

Uppdatera ett ansikte

Med det här kommandot kan du uppdatera ett ansikte i videon med ett namn med hjälp av ID:t för videon och ID:t för ansiktet. Den här åtgärden uppdaterar sedan personmodellen som videon var associerad med vid uppladdning/indexering eller omindexering. Om ingen personmodell har tilldelats uppdateras kontots standardmodell för person.

Systemet identifierar sedan förekomsterna av samma ansikte i dina andra aktuella videor som delar samma personmodell. Det kan ta lite tid att känna igen ansiktet i dina andra aktuella videor eftersom det här är en batchprocess.

Du kan uppdatera ett ansikte som Azure AI Video Indexer känner igen som en kändis med ett nytt namn. Det nya namnet som du ger kommer att ha företräde framför det inbyggda kändisigenkänningen.

Om du vill uppdatera ansiktet använder du uppdatera ett API för videoigenkänning .

Namn är unika för personmodeller, så om du ger två olika ansikten i samma personmodell samma name parametervärde, visar Azure AI Video Indexer ansikten som samma person och konvergerar dem när du har indexat om videon.