Anpassen eines Markenmodells 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.
Azure AI Video Indexer unterstützt die Markenerkennung von Sprach- und visuellem Text während der Indizierung und Neuindizierung von Video- und Audioinhalten. Das Feature zur Erkennung von Marken identifiziert Erwähnungen von Produkten, Diensten und Unternehmen, die von der Markendatenbank von Bing vorgeschlagen werden. Wenn Microsoft beispielsweise in Video- oder Audioinhalten Erwähnung oder in visuellem Text in einem Video angezeigt wird, erkennt Azure AI Video Indexer sie als Marke im Inhalt. Ein benutzerdefiniertes Markenmodell ermöglicht es Ihnen, bestimmte Marken von der Erkennung auszuschließen und Marken einzubeziehen, die Teil Ihres Modells sein sollten und sich möglicherweise nicht in der Markendatenbank von Bing befinden. Weitere Informationen finden Sie in der Übersicht.
Hinweis
Wenn Ihr Video vor dem Hinzufügen einer Marke indiziert wurde, müssen Sie es neu indizieren.
Sie können die Azure AI Video Indexer-APIs verwenden, um benutzerdefinierte Markenmodelle zu erstellen, zu verwenden und 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 Markenmodells mithilfe der Azure AI Video Indexer-Website beschrieben.
Erstellen einer Marke
Mit der API zum Erstellen einer Marke wird eine neue benutzerdefinierte Marke erstellt und dem benutzerdefinierten Markenmodell für das angegebene Konto hinzugefügt.
Hinweis
Wenn Die Einstellung enabled (im Textkörper) auf "true" festgelegt wird, wird die Marke in die Liste "Einschließen " für Azure AI Video Indexer eingefügt, die erkannt werden soll. Wenn sie enabled auf "false" festgelegt ist, wird die Marke in die Liste "Ausschließen " gesetzt, sodass der Azure AI Video Indexer sie nicht erkennt.
Einige weitere Parameter, die Sie im Text festlegen können:
- Der Wert
referenceUrlkann eine beliebige Referenzwebsite für die Marke sein, z. B. ein Link zur entsprechenden Wikipedia-Seite. - Der Wert
tagsist eine Liste der Tags für die Marke. Dieses Tag wird im Feld "Kategorie" der Marke auf der Azure AI Video Indexer-Website angezeigt. Beispielsweise kann die Marke „Azure“ als „Cloud“ gekennzeichnet oder eingestuft werden.
Antwort
Die Antwort liefert Informationen über die soeben erstellte Marke gemäß dem Format des folgenden Beispiels.
{
"referenceUrl": "https://en.wikipedia.org/wiki/Example",
"id": 97974,
"name": "Example",
"accountId": "SampleAccountId",
"lastModifierUserName": "SampleUserName",
"created": "2018-04-25T14:59:52.7433333",
"lastModified": "2018-04-25T14:59:52.7433333",
"enabled": true,
"description": "This is an example",
"tags": [
"Tag1",
"Tag2"
]
}
Löschen einer Marke
Die API zum Löschen einer Marke entfernt eine Marke aus dem benutzerdefinierten Markenmodell für das angegebene Konto. Das Konto wird im Parameter accountId angegeben. Nach einem erfolgreichen Aufruf wird die Marke nicht mehr in den Markenlisten Einbeziehen oder Ausschließen enthalten sein.
Antwort
Es wird kein Inhalt zurückgegeben, wenn die Marke erfolgreich gelöscht wurde.
Abrufen einer bestimmten Marke
Mit der API zum Abrufen einer Marke können Sie im benutzerdefinierten Markenmodell für das angegebene Konto nach den Details einer Marke anhand der Marken-ID suchen.
Antwort
Die Antwort liefert Informationen über die gesuchte Marke (mithilfe der Marken-ID) gemäß dem Format des folgenden Beispiels.
{
"referenceUrl": "https://en.wikipedia.org/wiki/Example",
"id": 128846,
"name": "Example",
"accountId": "SampleAccountId",
"lastModifierUserName": "SampleUserName",
"created": "2018-01-06T13:51:38.3666667",
"lastModified": "2018-01-11T13:51:38.3666667",
"enabled": true,
"description": "This is an example",
"tags": [
"Tag1",
"Tag2"
]
}
Hinweis
enabled wird true so festgelegt, dass sich die Marke in der Liste "Einschließen " für azure AI Video Indexer befindet, um sie zu erkennen, und enabled falsch bedeutet, dass sich die Marke in der Liste "Ausschließen" befindet, sodass azure AI Video Indexer sie nicht erkennt.
Aktualisieren einer bestimmten Marke
Mit der API zum Aktualisieren einer Marke können Sie im benutzerdefinierten Markenmodell für das angegebene Konto nach den Details einer Marke anhand der Marken-ID suchen.
Antwort
Die Antwort liefert aktualisierte Informationen über die aktualisierte Marke gemäß dem Format des folgenden Beispiels.
{
"referenceUrl": null,
"id": 97974,
"name": "Example",
"accountId": "SampleAccountId",
"lastModifierUserName": "SampleUserName",
"Created": "2018-04-25T14:59:52.7433333",
"lastModified": "2018-04-25T15:37:50.67",
"enabled": false,
"description": "This is an update example",
"tags": [
"Tag1",
"NewTag2"
]
}
Abrufen aller Marken
Die API zum Abrufen aller Marken gibt alle Marken im benutzerdefinierten Markenmodell für das angegebene Konto zurück, unabhängig davon, ob die Marke in der Einschlussliste oder der Ausschlussliste für Marken enthalten sein soll.
Antwort
Die Antwort enthält eine Liste mit allen Marken in Ihrem Konto und deren Details im Format wie im folgenden Beispiel.
[
{
"ReferenceUrl": null,
"id": 97974,
"name": "Example",
"accountId": "AccountId",
"lastModifierUserName": "UserName",
"Created": "2018-04-25T14:59:52.7433333",
"LastModified": "2018-04-25T14:59:52.7433333",
"enabled": true,
"description": "This is an example",
"tags": ["Tag1", "Tag2"]
},
{
"ReferenceUrl": null,
"id": 97975,
"name": "Example2",
"accountId": "AccountId",
"lastModifierUserName": "UserName",
"Created": "2018-04-26T14:59:52.7433333",
"LastModified": "2018-04-26T14:59:52.7433333",
"enabled": false,
"description": "This is another example",
"tags": ["Tag1", "Tag2"]
},
]
Hinweis
Die Marke mit dem Namen "Example " befindet sich in der Liste "Einschließen " für azure AI Video Indexer, die erkannt werden soll, und die Marke " Example2 " befindet sich in der Liste "Ausschließen ", sodass azure AI Video Indexer sie nicht erkennt.
Abrufen der Einstellungen für das Markenmodell
Die API zum Abrufen der Markeneinstellungen gibt die Einstellungen des Markenmodells im angegebenen Konto zurück. Die Einstellungen des Markenmodells geben an, ob die Erkennung über die Bing-Markendatenbank aktiviert ist. Wenn Bing-Marken nicht aktiviert sind, erkennt Azure AI Video Indexer nur Marken aus dem benutzerdefinierten Markenmodell des angegebenen Kontos.
Antwort
Die Antwort zeigt, ob Bing-Marken im Format des folgenden Beispiels aktiviert sind.
{
"state": true,
"useBuiltIn": true
}
Hinweis
Wenn useBuiltIn auf „true“ festgelegt ist, bedeutet dies, dass die Bing-Marken aktiviert sind. Wenn useBuiltin auf „false“ festgelegt ist, bedeutet dies, dass die Bing-Marken deaktiviert sind. Der state-Wert kann ignoriert werden, da er veraltet ist.
Aktualisieren der Einstellungen für das Markenmodell
Die API zum Aktualisieren von Marken aktualisiert die Einstellungen des Markenmodells im angegebenen Konto. Die Einstellungen des Markenmodells geben an, ob die Erkennung über die Bing-Markendatenbank aktiviert ist. Wenn Bing-Marken nicht aktiviert sind, erkennt Azure AI Video Indexer nur Marken aus dem benutzerdefinierten Markenmodell des angegebenen Kontos.
Wenn das useBuiltIn-Flag auf „true“ festgelegt ist, bedeutet dies, dass die Bing-Marken aktiviert sind. Wenn useBuiltin auf „false“ festgelegt ist, bedeutet dies, dass die Bing-Marken deaktiviert sind.
Antwort
Es wird kein Inhalt zurückgegeben, wenn die Einstellung für das Markenmodell erfolgreich aktualisiert wurde.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für