Azure AI Video Indexer API を使用してブランド モデルをカスタマイズする

  • [アーティクル]

重要

Azure Media Services の 提供終了の発表により、Azure AI Video Indexer は Azure AI Video Indexer の 機能の調整を発表します。 Azure AI Video Indexer アカウントの意味を理解するには、Azure Media Service (AMS) の提供終了に関連する変更に関するページを参照してください。 AMS 提供 終了の準備: VI の更新と移行に関するガイドを参照してください。

Azure AI Video Indexer では、ビデオとオーディオ コンテンツのインデックスの作成および再作成中に、音声と視覚テキストからのブランドの検出がサポートされます。 ブランド検出機能では、Bing のブランド データベースで提案される製品、サービス、および企業の説明が識別されます。 たとえば、ビデオまたはオーディオ コンテンツの中で Microsoft が言及された場合や、ビデオ内の視覚テキストに現れた場合、Azure AI Video Indexer によってそれがコンテンツ内のブランドとして検出されます。 カスタム ブランド モデルでは、特定のブランドを検出対象から除外し、Bing のブランド データベースにはない可能性があるモデルの一部である必要があるブランドを含めることができます。 詳細については、「概要」を参照してください。

Note

ブランド追加に先立ってビデオにインデックスを付けた場合、インデックスを再作成する必要があります。

このトピックで説明されているように、Azure AI Video Indexer API を使って、ビデオで検出されるカスタム ブランド モデルを作成、使用、および編集することができます。 また、「Azure AI Video Indexer Web サイトを使用したブランド モデルのカスタマイズ」で説明されているように、Azure AI Video Indexer Web サイトを使用することもできます。

ブランドを作成する

ブランドの作成 API では、新しいカスタム ブランドを作成し、指定されたアカウント用のカスタム ブランド モデルに追加します。

Note

enabled (本文内) を [true] に設定すると、Azure AI Video Indexer での検出対象として [含める] リストにブランドが配置されます。 enabled を [false] に設定すると、[除外] リストにブランドが配置されます。したがって、Azure AI Video Indexer では検出されません。

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

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

ブランドを削除する

ブランドの削除 API では、指定されたアカウントのカスタム ブランド モデルからブランドを削除します。 アカウントは accountId パラメーターで指定されます。 呼び出しが正常に行われると、ブランドは、[含める] や [除外] のブランド リストに配置されなくなります。

回答

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

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

ブランドの取得 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"
  ]
}

Note

enabled が true に設定されている場合、ブランドが Azure AI Video Indexer での検出対象として [含める] リストにあることを意味します。enabled が false の場合、ブランドが [除外] リストにあることを意味するため、Azure AI Video Indexer では検出されません。

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

ブランドの更新 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 では、ブランドが "対象" と "除外" のどちらのブランド リストに配置されるようになっているかに関係なく、指定されたアカウント用のカスタム ブランド モデルのブランドがすべて返されます。

回答

応答では、以下の例の形式に従って、アカウント内のすべてのブランドとそれらの詳細がそれぞれリストされます。

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

Note

Example という名前のブランドは、Azure AI Video Indexer での検出対象として [含める] リストにあります。Example2 という名前のブランドは、[除外] リストにあるため、Azure AI Video Indexer では検出されません。

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

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

回答

応答では、次の例の形式に従って、Bing ブランドが有効かどうかが示されます。

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

Note

useBuiltIn が true に設定されている場合、Bing ブランドが有効であることを表します。 useBuiltin が false の場合、Bing ブランドは無効です。 state 値は、推奨されていないため、無視してかまいません。

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

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

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

回答

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