使用 Azure AI 视频索引器 API 自定义品牌模型

项目
11/21/2023

重要

由于 Azure 媒体服务停用公告，Azure 视频索引器宣布了 Azure AI 视频索引器功能调整。请参阅与 Azure 媒体服务 (AMS) 停用相关的更改，了解这对 Azure 视频索引器帐户意味着什么。

Azure AI 视频索引器支持在索引和重新编制视频和音频内容索引期间从语音和视觉文本进行品牌检测。品牌检测功能可以确定内容中是否提到必应品牌数据库建议的产品、服务和公司。例如，如果 Microsoft 在视频或音频内容中提及，或者它以视频中的视觉文本显示，Azure AI 视频索引器会将其检测为内容中的品牌。使用自定义品牌模型时，可以排除某些品牌，不让其检测到；还可以添加一些品牌，这些品牌应该在你的模型中，但可能不在必应的品牌数据库中。有关详细信息，请参阅概述。

注意

如果在添加品牌之前已为视频编制了索引，则需要对其重新编制索引。

可以使用 Azure AI 视频索引器 API 创建、使用和编辑视频中检测到的自定义品牌模型，如本主题中所述。还可以使用 Azure AI 视频索引器网站，如使用 Azure AI 视频索引器网站自定义品牌模型中所述。

创建品牌

创建品牌 API 会创建新的自定义品牌，并将其添加到指定帐户的自定义品牌模型。

注意

将（在正文中）设置为 enabled true 会将品牌置于 要检测的 Azure AI 视频索引器的“包括 ”列表中。设置为 enabled false 会将品牌置于“排除”列表中，因此 Azure AI 视频索引器不会检测到它。

可在正文中设置的一些其他参数：

referenceUrl 值可以是该品牌的任何参考网站，例如它的维基百科页面的链接。
tags 值是该品牌的标记的列表。此标记显示在 Azure AI 视频索引器网站的品牌类别字段中。例如，品牌“Azure”可以标记或归类为“云”。

响应

响应介绍刚刚按照以下示例的格式创建的品牌。

{
  "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"
  ]
}

删除品牌

删除品牌 API 会从指定帐户的自定义品牌模型中删除品牌。该帐户是在 accountId 参数中指定的。成功调用以后，品牌将不再位于 Include 或 Exclude 品牌列表中。

响应

在成功删除品牌后，没有内容返回。

获取特定的品牌

利用获取品牌 API，可以使用品牌 ID 在指定帐户的自定义品牌模型中搜索品牌的详细信息。

响应

响应介绍按照以下示例的格式搜索（使用品牌 ID）的品牌。

{
  "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"
  ]
}

注意

enabled 设置为 true 表示该品牌位于 Azure AI 视频索引器的 Include 列表中以检测，并且 enabled 为 false 表示该品牌位于 “排除 ”列表中，因此 Azure AI 视频索引器不会检测到它。

更新特定品牌

利用更新品牌 API，你可以使用品牌 ID 在指定帐户的自定义品牌模型中搜索品牌的详细信息。

响应

响应按照以下示例的格式针对更新的品牌提供更新的信息。

{
  "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"
  ]
}

获取所有品牌

获取所有品牌 API 返回指定帐户的自定义品牌模型中的所有品牌，无论该品牌是应该在 Include 品牌列表中，还是应该在 Exclude 品牌列表中。

响应

响应提供一个列表，其中包含帐户中的所有品牌，以及遵循以下示例格式的每个品牌的详细信息。

[
    {
        "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"]
    },
]

注意

名为 Example 的品牌位于 要检测的 Azure AI 视频索引器的 Include 列表中，名为 Example2 的品牌位于 “排除 ”列表中，因此 Azure AI 视频索引器不会检测到它。

获取品牌模型设置

获取品牌设置 API 返回指定帐户中的品牌模型设置。品牌模型设置表示是否启用从必应品牌数据库进行检测的功能。如果未启用必应品牌，Azure AI 视频索引器将仅检测指定帐户的自定义品牌模型中的品牌。

响应

响应显示是否已按照以下示例的格式启用必应品牌。

{
  "state": true,
  "useBuiltIn": true
}

注意

useBuiltIn 设置为 true 表示启用必应品牌。如果 useBuiltin 为 false，则表示禁用必应品牌。可以忽略 state 值，因为它是已弃用的。

更新品牌模型设置

更新品牌 API 更新指定帐户中的品牌模型设置。品牌模型设置表示是否启用从必应品牌数据库进行检测的功能。如果未启用必应品牌，Azure AI 视频索引器将仅检测指定帐户的自定义品牌模型中的品牌。

useBuiltIn 标志设置为 true 表示启用必应品牌。如果 useBuiltin 为 false，则表示禁用必应品牌。

响应

在成功更新品牌模型设置后，没有内容返回。

后续步骤

使用网站自定义品牌模型