Anpassen eines Personenmodells mit der Azure AI Video Indexer-API

Wichtig

Aufgrund der Ankündigung zur Einstellung von Azure Media Services kündigt Azure AI Video Indexer Anpassungen an. Siehe Änderungen im Zusammenhang mit der Einstellung von Azure Media Service (AMS), um zu verstehen, was dies für Ihr Azure AI Video Indexer-Konto bedeutet. Weitere Informationen finden Sie im Leitfaden zur Vorbereitung auf die Einstellung von AMS: VI-Update und -Migration.

Hinweis

Der Zugriff auf Funktionen zur Gesichtserkennung, Anpassung und Erkennung von Prominenten ist auf der Grundlage von Berechtigungs- und Nutzungskriterien beschränkt, um unsere Prinzipien der verantwortungsbewussten KI zu unterstützen. Funktionen zur Gesichtserkennung, Anpassung und Erkennung von Prominenten sind nur für von Microsoft verwaltete Kunden und Partner verfügbar. Verwenden Sie das Aufnahmeformular für die Gesichtserkennung, um sich für den Zugriff zu bewerben.

Azure AI Video Indexer unterstützt Gesichtserkennung und Prominenteerkennung für Videoinhalte. Das Feature zur Erkennung von Prominenten umfasst ungefähr eine Million Gesichter, die auf häufig angeforderten Datenquellen wie IMDB, Wikipedia und den wichtigsten LinkedIn-Influencern basieren. Gesichter, die vom Feature zur Erkennung von Prominenten nicht erkannt werden, werden erfasst, bleiben aber unbenannt. Nachdem Sie Ihr Video in den Azure AI Video Indexer hochgeladen und Ergebnisse erhalten haben, können Sie zurückkehren und die Gesichter benennen, die nicht erkannt wurden. Sobald Sie ein Gesicht mit einem Namen versehen haben, werden Gesicht und Name dem Personenmodell Ihres Kontos hinzugefügt. Azure AI Video Indexer erkennt dieses Gesicht dann in Ihren zukünftigen Videos und früheren Videos.

Sie können die Azure AI Video Indexer-API verwenden, um Gesichter zu bearbeiten, die in einem Video erkannt wurden, wie in diesem Thema beschrieben. Sie können auch die Azure AI Video Indexer-Website verwenden, wie unter Anpassen des Personenmodells mithilfe der Azure AI Video Indexer-Website beschrieben.

Verwalten mehrerer Personenmodelle

Azure AI Video Indexer unterstützt mehrere Personenmodelle pro Konto. Dieses Feature ist derzeit nur über die Azure AI Video Indexer-APIs verfügbar.

Wenn Ihr Konto verschiedenen Anwendungsszenarien entspricht, sollten Sie möglicherweise mehrere Personenmodelle pro Konto erstellen. Wenn sich Ihre Inhalte z. B. mit dem Thema „Sport“ befassen, können Sie dann für jede Sportart (Football, Basketball, Fußball usw.) ein separates Personenmodell erstellen.

Sobald ein Modell erstellt wurde, können Sie es verwenden, indem Sie die Modell-ID eines bestimmten Personenmodells beim Hochladen/Indizieren oder erneuten Indizieren eines Videos angeben. Beim Trainieren eines neuen Gesichts für ein Video wird das bestimmte benutzerdefinierte Modell, dem das Video zugeordnet war, aktualisiert.

Jedes Konto hat ein Limit von 50 Personenmodellen. Wenn Sie keine Unterstützung für Mehrpersonenmodelle benötigen, weisen Sie Ihrem Video beim Hochladen/Indizieren oder erneuten Indizieren keine Personenmodell-ID zu. In diesem Fall verwendet Azure AI Video Indexer das standardmäßige benutzerdefinierte Personenmodell in Ihrem Konto.

Erstellen eines neuen Personenmodells

Um ein neues Personenmodell im angegebenen Konto zu erstellen, verwenden Sie die API zum Erstellen eines neuen Personenmodells.

Die Antwort stellt den Namen und die generierte Modell-ID des Personenmodells bereit, das Sie gerade im Format des folgenden Beispiels erstellt haben.

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

Sie verwenden dann den Wert id für den Parameter personModelId, wenn ein zu indizierendes Video hochgeladen oder ein Video neu indiziert wird.

Löschen eines Personenmodells

Um ein benutzerdefiniertes Personenmodell im angegebenen Konto zu löschen, verwenden Sie die API zum Löschen eines Personenmodells.

Sobald das Personenmodell erfolgreich gelöscht wurde, bleibt der Index Ihrer aktuellen Videos, die das gelöschte Modell verwendet haben, unverändert, bis Sie sie neu indizieren. Beim erneuten Indizieren werden die Gesichter, die im gelöschten Modell benannt wurden, in Ihren aktuellen Videos, die mit diesem Modell indiziert wurden, von Azure AI Video Indexer nicht erkannt, die Gesichter werden jedoch weiterhin erkannt. Ihre aktuellen Videos, die mit dem gelöschten Modell indiziert wurden, verwenden nun das Standardpersonenmodell Ihres Kontos. Wenn Gesichter aus dem gelöschten Modell auch im Standardmodell Ihres Kontos benannt sind, werden diese Gesichter in den Videos weiterhin erkannt.

Es wird kein Inhalt zurückgegeben, wenn das Personenmodell erfolgreich gelöscht wurde.

Abrufen aller Personenmodelle

Um alle Personenmodelle im angegebenen Konto abzurufen, verwenden Sie die API zum Abrufen eines Personenmodells.

Die Antwort enthält eine Liste aller Personenmodelle in Ihrem Konto (einschließlich des Standardpersonenmodells in dem angegebenen Konto) sowie deren Namen und IDs im Format des folgenden Beispiels.

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

Sie können auswählen, welches Modell Sie für ein Video verwenden möchten, indem Sie den Wert id des Personenmodells für den Parameter personModelId verwenden, wenn Sie ein zu indizierendes Video hochladen oder ein Video neu indizieren.

Gesicht aktualisieren

Mit diesem Befehl können Sie ein Gesicht in Ihrem Video mit einem Namen aktualisieren, indem Sie die ID des Videos und die ID des Gesichts verwenden. Durch diese Aktion wird das Personenmodell aktualisiert, dem das Video beim Hochladen/Indizieren oder erneuten Indizieren zugeordnet wurde. Wenn kein Personenmodell zugewiesen wurde, wird das Standardpersonenmodell des Kontos aktualisiert.

Das System erkennt dann die Vorkommen desselben Gesichts in Ihren anderen aktuellen Videos, die dasselbe Personenmodell verwenden. Die Erkennung des Gesichts in Ihren anderen aktuellen Videos kann einige Zeit in Anspruch nehmen, da es sich um einen Batchprozess handelt.

Sie können ein Gesicht aktualisieren, das Azure AI Video Indexer als Prominente mit einem neuen Namen erkannt hat. Der neue Name, den Sie vergeben, hat Vorrang vor der integrierten Erkennung von Prominenten.

Um das Gesicht zu aktualisieren, verwenden Sie die API zum Aktualisieren eines Gesichts im Video.

Namen sind für Personenmodelle eindeutig. Wenn Sie also zwei verschiedene Gesichter im selben Personenmodell denselben name Parameterwert angeben, zeigt Azure AI Video Indexer die Gesichter als dieselbe Person an und konvergiert sie, sobald Sie Ihr Video neu indizieren.