Azure AI Video Indexer API を使用して人物モデルをカスタマイズする

[アーティクル]
03/22/2024

重要

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

Note

責任ある AI の原則をサポートするために、顔識別、カスタマイズ、および著名人認識機能のアクセスは、適格性と使用基準に基づいて制限されています。顔識別、カスタマイズ、および著名人認識機能は、Microsoft が管理するお客様とパートナーのみが利用できます。顔認識受付フォームを使用して利用申請を行ってください。

Azure AI Video Indexer では、ビデオコンテンツの顔検出と著名人認識がサポートされています。著名人認識機能では、IMDB、Wikipedia、LinkedIn のトップインフルエンサーなど、よく要求されるデータソースに基づいて、約 100 万人の顔を処理できます。著名人認識機能によって認識されない顔も検出されますが、それらは名前が未設定のままになります。 Azure AI Video Indexer に動画をアップロードし、結果を取得した後で、認識されなかった顔に名前を付けることができます。顔に名前のラベルを付けると、顔と名前がお使いのアカウントの人物モデルに追加されます。その後、Azure AI Video Indexer によって、その顔が今後の動画と過去の動画で認識されるようになります。

Azure AI Video Indexer API を使用して、動画で検出された顔を編集することができます。これについては、このトピックで説明します。また、Azure AI Video Indexer Web サイトを使用した人物モデルのカスタマイズに関するページで説明されているように、Azure AI Video Indexer Web サイトを使用することもできます。

複数の人物モデルの管理

Azure AI Video Indexer では、アカウントごとに複数の人物モデルがサポートされます。この機能は現在、Azure AI Video Indexer API を通じてのみ利用可能です。

ご利用のアカウントがさまざまなユースケースシナリオに対応している場合は、アカウントごとに複数の人物モデルを作成することができます。たとえば、コンテンツがスポーツに関連している場合、スポーツ (フットボール、バスケットボール、サッカーなど) ごとに別個の人物モデルを作成できます。

モデルが作成されたら、ビデオのアップロード/インデックスの作成または再作成の際に、特定の人物モデルのモデル ID を指定して使用できます。ビデオの新しい顔のトレーニングを行うと、そのビデオが関連付けられた特定のカスタムモデルが更新されます。

各アカウントの人物モデルの数は 50 に制限されています。複数の人物モデルをサポートする必要がない場合は、アップロード時やインデックスの作成または再作成時に、ビデオに人物モデル ID を割り当てないでください。この場合、Azure AI Video Indexer でアカウント内の既定のカスタム人物モデルが使用されます。

新しい人物モデルを作成する

指定されたアカウントで新しい人物モデルを作成するには、Create Person Model API を使用します。

応答では、以下の例の形式に従って、先ほど作成した人物モデルの名前と生成されたモデル ID が提供されます。

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

その後、インデックスを作成するためにビデオをアップロードするときや、ビデオのインデックスを再作成するときに、personModelId パラメーターに id 値を使用します。

人物モデルを削除する

指定されたアカウントからカスタムの人物モデルを削除するには、Delete Person Model API を使用します。

人物モデルが正常に削除された後、削除されたモデルを使用していた現在のビデオのインデックスは再作成されるまで変わりません。インデックスを再作成すると、削除されたモデルで名前が付けられていた顔は、そのモデルを使用してインデックスが作成された現在の動画で Azure AI Video Indexer によって認識されなくなりますが、顔は引き続き検出されます。削除されたモデルを使用してインデックスが作成された現在のビデオでは、アカウントの既定の人物モデルが使用されるようになります。アカウントの既定のモデルでも削除されたモデルの顔に名前が付けられている場合、それらの顔はビデオで引き続き認識されます。

人物モデルが正常に削除されたときに返されるコンテンツはありません。

すべての人物モデルを取得する

指定されたアカウントのすべての人物モデルを取得するには、Get Person Models API を使用します。

応答では、アカウント内のすべての人物モデル (指定されたアカウント内の既定の人物モデルを含む) のリストが提供され、以下の例の形式に従ってそれぞれの名前と ID が示されます。

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

ビデオで使用するモデルは選択できます。それには、インデックスを作成するためにビデオをアップロードするとき、またはビデオのインデックスを再作成するときに、personModelId パラメーターの人物モデルの id 値を使用します。

顔を更新する

このコマンドでは、ビデオの ID と顔の ID を使用し、名前でビデオの顔を更新できます。この操作によって、アップロード時やインデックスの作成または再作成時にビデオが関連付けられた人物モデルが更新されます。人物モデルが割り当てられていない場合は、アカウントの既定の人物モデルが更新されます。

システムでは次に、同じ人物モデルを共有している、現在のその他のビデオに出現する同じ顔が認識されます。他の現在のビデオの顔の認識は、バッチプロセスであるため、有効になるまで少し時間がかかることがあります。

Azure AI Video Indexer で著名人として認識された顔は、新しい名前で更新できます。指定した新しい名前は、組み込みの著名人認識より優先されます。

顔を更新するには、Update Video Face API を使用します。

名前は人物モデルで一意であるため、同じ人物モデルの 2 つの異なる顔に、同じ name パラメーター値を指定した場合、Azure AI Video Indexer ではこれらの顔は同じ人物であると見なされて、それらの顔は、動画のインデックスを再作成するときに集約されます。