Dostosowywanie modelu osoby przy użyciu interfejsu API usługi Azure AI Video Indexer

Ważne

Ze względu na ogłoszenie wycofania usługi Azure Media Services usługa Azure AI Video Indexer ogłasza zmiany funkcji usługi Azure AI Video Indexer. Zobacz Zmiany związane z wycofaniem usługi Azure Media Service (AMS), aby dowiedzieć się, co to oznacza dla konta usługi Azure AI Video Indexer. Zobacz Przewodnik Przygotowywanie do wycofania usługi AMS: VI aktualizacji i migracji.

Uwaga

Dostęp do funkcji identyfikacji twarzy, dostosowywania i rozpoznawania osobistości jest ograniczony w oparciu o kryteria uprawnień i użycia w celu obsługi naszych zasad odpowiedzialnej sztucznej inteligencji. Funkcje identyfikacji twarzy, dostosowywania i rozpoznawania osobistości są dostępne tylko dla klientów i partnerów zarządzanych przez firmę Microsoft. Użyj formularza do wprowadzania rozpoznawania twarzy, aby ubiegać się o dostęp.

Usługa Azure AI Video Indexer obsługuje wykrywanie twarzy i rozpoznawanie osobistości dla zawartości wideo. Funkcja rozpoznawania osobistości obejmuje około miliona twarzy na podstawie powszechnie żądanego źródła danych, takiego jak IMDB, Wikipedia i najważniejsze elementy mające wpływ linkedin. Twarze, które nie są rozpoznawane przez funkcję rozpoznawania osobistości, są wykrywane, ale pozostawione bez nazwy. Po przekazaniu wideo do usługi Azure AI Video Indexer i powrocie wyników możesz wrócić i nazwać twarze, które nie zostały rozpoznane. Po oznaczeniu etykiety twarzy nazwą twarz i nazwa są dodawane do modelu osoby twojego konta. Usługa Azure AI Video Indexer rozpozna tę twarz w przyszłych filmach wideo i poprzednich filmach wideo.

Interfejs API usługi Azure AI Video Indexer umożliwia edytowanie twarzy wykrytych w filmie wideo zgodnie z opisem w tym temacie. Możesz również użyć witryny internetowej usługi Azure AI Video Indexer zgodnie z opisem w temacie Dostosowywanie modelu osoby przy użyciu witryny internetowej usługi Azure AI Video Indexer.

Zarządzanie wieloma modelami osób

Usługa Azure AI Video Indexer obsługuje wiele modeli osób na konto. Ta funkcja jest obecnie dostępna tylko za pośrednictwem interfejsów API usługi Azure AI Video Indexer.

Jeśli Twoje konto obsługuje różne scenariusze przypadków użycia, możesz utworzyć wiele modeli osób na konto. Jeśli na przykład zawartość jest powiązana z sportem, możesz utworzyć oddzielny model osoby dla każdego sportu (piłka nożna, koszykówka, piłka nożna itp.).

Po utworzeniu modelu można go użyć, podając identyfikator modelu określonego modelu osoby podczas przekazywania/indeksowania lub ponownego indeksowania wideo. Trenowanie nowej twarzy filmu wideo aktualizuje konkretny model niestandardowy, z którą został skojarzony film wideo.

Każde konto ma limit 50 modeli osób. Jeśli nie potrzebujesz obsługi wielu modeli osób, nie przypisz identyfikatora modelu Osoby do filmu wideo podczas przekazywania/indeksowania lub ponownego indeksowania. W takim przypadku usługa Azure AI Video Indexer używa domyślnego niestandardowego modelu osoby na twoim koncie.

Tworzenie nowego modelu osoby

Aby utworzyć nowy model osoby na określonym koncie, użyj interfejsu API tworzenia modelu osoby.

Odpowiedź zawiera nazwę i wygenerowany identyfikator modelu osoby, który został właśnie utworzony zgodnie z formatem poniższego przykładu.

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

Następnie użyj wartości identyfikatoradla parametru personModelId podczas przekazywania wideo do indeksowania lub ponownego indeksowania wideo.

Usuwanie modelu osoby

Aby usunąć niestandardowy model osoby z określonego konta, użyj interfejsu API usuwania modelu osoby.

Po pomyślnym usunięciu modelu osoby indeks bieżących filmów wideo, które korzystały z usuniętego modelu, pozostanie niezmieniony, dopóki nie zostaną ponownie zindeksowane. Po ponownym indeksowaniu twarze, które zostały nazwane w usuniętym modelu, nie zostaną rozpoznane przez usługę Azure AI Video Indexer w bieżących filmach wideo, które zostały indeksowane przy użyciu tego modelu, ale twarze będą nadal wykrywane. Bieżące filmy wideo, które zostały zindeksowane przy użyciu usuniętego modelu, będą teraz używać domyślnego modelu osoby konta. Jeśli twarze z usuniętego modelu są również nazwane w domyślnym modelu konta, te twarze będą nadal rozpoznawane w filmach wideo.

Po pomyślnym usunięciu modelu osoby nie ma zwracanej zawartości.

Pobieranie wszystkich modeli osób

Aby pobrać wszystkie modele osób na określonym koncie, użyj interfejsu API pobierania modelu osoby.

Odpowiedź zawiera listę wszystkich modeli osób na twoim koncie (w tym domyślny model osoby na określonym koncie) oraz każdy z ich nazw i identyfikatorów zgodnie z formatem poniższego przykładu.

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

Możesz wybrać model, którego chcesz użyć dla wideo, używając id wartości modelu Person dla personModelId parametru podczas przekazywania filmu wideo do indeksowania lub ponownego indeksowania wideo.

Aktualizowanie twarzy

To polecenie umożliwia zaktualizowanie twarzy w filmie wideo przy użyciu nazwy przy użyciu identyfikatora wideo i identyfikatora twarzy. Ta akcja spowoduje zaktualizowanie modelu Osoby, z którą film wideo został skojarzony podczas przekazywania/indeksowania lub ponownego indeksowania. Jeśli model person nie został przypisany, aktualizuje domyślny model osoby konta.

Następnie system rozpoznaje wystąpienia tej samej twarzy w innych bieżących filmach wideo, które współużytkuje ten sam model osoby. Rozpoznawanie twarzy w innych bieżących filmach wideo może zająć trochę czasu, ponieważ jest to proces wsadowy.

Możesz zaktualizować twarz, którą usługa Azure AI Video Indexer rozpoznała jako gwiazdę z nową nazwą. Nowa nazwa, którą nadasz, będzie mieć pierwszeństwo przed wbudowanym rozpoznawaniem osobistości.

Aby zaktualizować twarz, użyj interfejsu API aktualizacji twarzy wideo.

Nazwy są unikatowe dla modeli osób, więc jeśli nadasz dwa różne twarze w tym samym modelu osoby, ta sama name wartość parametru, usługa Azure AI Video Indexer wyświetla twarze jako tę samą osobę i konweruje je po ponownym indeksie wideo.