Azure AI Video Indexer でブランド モデルをカスタマイズする

Azure AI Video Indexer では、ビデオとオーディオ コンテンツのインデックスの作成および再作成中に、音声と視覚テキストからのブランドの検出がサポートされます。 ブランド検出は、Bingのブランド データベースによって提案された製品、サービス、および企業の言及を識別します。 たとえば、Microsoft がビデオまたはオーディオ コンテンツに記載されている場合や、ビデオのビジュアル テキストに表示される場合、Azure AI Video Indexer はそれをブランドとして検出します。

ブランドは、コンテキストを使用して、他の用語と区別されます。

作成したカスタム ブランド モデルは、モデルを作成したアカウントでのみ使用できます。

ブランド モデルをカスタマイズすると、次のことができます。

• Azure AI Video Indexer が Bing ブランド データベースからブランドを検出するかどうかを選択する
• 特定のブランドが検出されないようにする (基本的に未承認のブランドの一覧を作成する)
• Bingのブランド データベース (承認済みブランド) にない可能性がある、モデルの一部であるブランドを含めます。

Note

ブランド追加に先立ってビデオにインデックスを付けた場合、インデックスを再作成する必要があります。 動画に関連付けられているドロップダウン メニューに [インデックスの再作成] 項目があります。 [詳細設定オプション] > [ブランドのカテゴリ] の順に選択し、[すべてのブランド] をオンにします。

前提条件

• Azure アカウント
• Azure AI Video Indexer アカウント

Web ポータル

ブランド モデルの設定を編集する

Bing ブランド データベースのブランドを検出するかどうかを設定できます。 このオプションを設定するには、ブランド モデルの設定を編集します。

1. Azure AI Video Indexer の Web サイトに移動してサインインします。
2. アカウント内のモデルをカスタマイズするには、ページの左にある [コンテンツ モデルのカスタマイズ] ボタンを選択します。
3. ブランドを編集するには、[ブランド] タブを選択します。
4. Azure AI Video Indexer で、Bing によって提案されたブランドを含める場合は、[Bing で提案されたブランドを表示する] オプションをオンにします。そうしない場合は、チェックボックスをオフのままにします。

モデルにブランドを含める

[ブランドを含める] セクションには、Bing によって提案されていなくても Azure AI Video Indexer で検出するカスタム ブランドが表示されます。

含めるリストにブランドを追加する

1. [+ Create new brand]\(+ 新しいブランドの作成\) を選択します。
2. 名前 (必須)、カテゴリ (省略可能)、説明 (省略可能)、参照 URL (省略可能) を指定します。
3. カテゴリ フィールドは、ブランドをタグ付けするためのものです。 このフィールドは、Azure AI Video Indexer API を使用している場合に、ブランドの "タグ" として表示されます。 たとえば、ブランドが "Azure" の場合、"クラウド" としてタグを付けたり、分類したりすることができます。
4. 参照用の URL フィールドは、Wikipedia ページへのリンクなど、ブランドの任意の参照 Web サイトにすることができます。
5. [保存] を選択します。 ブランドが Include brand リストに追加されます。

含めるリストのブランドを編集する

ブランドのカテゴリ、説明、参照 URL を更新できます。 ブランドの名前は一意であるため、変更することはできません。 ブランド名を変更する必要がある場合は、ブランド全体を削除し (次のセクションを参照してください)、新しい名前でブランドを新規作成してください。

1. 編集するブランドの横にある鉛筆アイコンを選択します。
2. [更新] ボタンをクリックし、新しい情報でブランドを更新します。

含めるリストのブランドを削除する

1. 削除するブランドの横にあるごみ箱アイコンを選択します。
2. [削除] を選択します。 ブランドが ブランド リストに含まれるようになりました。

モデルからのブランドを除外する

[ブランドの除外] セクションには、Azure AI Video Indexer で検出しないブランドが表示されます。

除外リストにブランドを追加する

1. [+ Create new brand]\(+ 新しいブランドの作成\) を選択します。
2. 名前 (必須)、カテゴリ (省略可能) を指定します。
3. [保存] を選択します。 ブランドが Exclude ブランド 一覧に追加されます。

除外リストのブランドを編集する

更新できるのは、ブランドのカテゴリのみです。 ブランドの名前は一意であるため、変更することはできません。 ブランド名を変更する必要がある場合は、ブランド全体を削除し (次のセクションを参照してください)、新しい名前でブランドを新規作成してください。

1. 編集するブランドの横にある鉛筆アイコンを選択します。
2. [更新] ボタンをクリックし、新しい情報でブランドを更新します。

除外リストのブランドを削除する

1. 削除するブランドの横にあるごみ箱アイコンを選択します。
2. [削除] を選択します。 Exclude ブランド一覧に長く表示されます。

API

Note

すべての要求について、 enabled を true に設定すると、検出する Azure AI Video Indexer の Include リストにブランドが配置されます。 enabledを false に設定すると、ブランドは Exclude リストに表示されるため、Azure AI Video Indexer では検出。

ブランドを作成する

Create Brand要求により、新しいカスタム ブランドが作成され、指定されたアカウントのカスタム ブランド モデルに追加されます。

本文で設定できるその他のパラメーターは次のとおりです。

• referenceUrl 値は、Wikipedia ページへのリンクなど、ブランドの参照 Web サイトにすることができます。
• tags 値はブランドのタグ リストです。 このタグは、Azure AI Video Indexer Web サイトのブランドの [カテゴリ] フィールドに表示されます。 たとえば、ブランドが "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"
  ]
}

ブランドを削除する

Delete Brand 要求は、指定されたアカウントのカスタム ブランド モデルからブランドを削除します。 アカウントは accountId パラメーターで指定されます。 ブランドが Include または Exclude ブランド リストに含まれるようになりました。

応答の例

ブランドが正常に削除されたときに返されるコンテンツはありません。

特定のブランドを取得する

Get Brand 要求を使用すると、ブランド 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"
  ]
}

特定のブランドを更新する

Update Brand 要求を使用すると、ブランド 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"
  ]
}

すべてのブランドを取得する

Get ブランド要求は、アカウントのカスタム ブランド (含まれる、除外) 内のすべてのブランドを返します。

応答の例

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

ブランド モデルの設定を取得する

Get Brands 要求は、指定されたアカウントのブランド モデル設定を返します。 モデル ブランド設定は、Bing ブランド データベースからの検出が有効であるかどうかを表します。 Bingブランドが有効になっていない場合、Azure AI Video Indexer は、指定されたアカウントのカスタム ブランド モデルからのブランドのみを検出します。

応答の例

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

ブランド モデルの設定を更新する

Update ブランド モデル設定要求は、指定されたアカウントのブランド モデル設定を更新します。 モデル ブランド設定は、Bing ブランド データベースからの検出が有効であるかどうかを表します。 Bingブランドが有効になっていない場合、Azure AI Video Indexer はカスタム ブランド モデルからのブランドのみを検出します。

useBuiltIn が true に設定されている場合、これは Bing ブランドが有効であることを意味します。 useBuiltin が false の場合、Bing ブランドは無効です。

応答の例

ブランド モデル設定が正常に更新されたときに返されるコンテンツはありません。