API コンソールでカスタムイメージリストを使用してモデレートする

[アーティクル]
01/18/2024

カスタムイメージリストを作成するには、Azure Content Moderator の List Management API を使用します。カスタムイメージリストは、Image Moderation API で使用します。イメージモデレーション操作では、イメージが表示されます。カスタムリストを作成すると、この操作で、イメージとカスタムリスト内のイメージとの比較も行われます。カスタムリストを使用して、イメージをブロックしたり許可したりできます。

注意

画像リスト数は 5 個、各リストの画像数は 10,000 個という上限があります。

List Management API を使用して、次のタスクを実行できます。

リストを作成します。
リストにイメージを追加する。
イメージをリスト内のイメージに照らしてスクリーニングする。
リストからイメージを削除する。
リストを削除する。
リストの情報を編集する。
リストに加えた変更が今後のスキャンに含まれるように、インデックスを最新の情報に更新する。

API コンソールを使用する

オンラインコンソールで API を試すには、サブスクリプションキーが必要です。これは、 [設定] タブの [Ocp-Apim-Subscription-Key] ボックス内にあります。詳細については、概要に関するページを参照してください。

検索インデックスを最新の情報に更新する

イメージリストに変更を加えた後は、変更が今後のスキャンに含まれるように、イメージリストのインデックスを最新の情報に更新する必要があります。この手順は、デスクトップ上の検索エンジン (有効になっている場合) や Web 検索エンジンが、新しいファイルやページが含まれるように絶えずインデックスを最新の情報に更新する方法と似ています。

Image List Management API リファレンスの左側のメニューで、[Image Lists](イメージリスト) を選択し、[Refresh Search Index](検索インデックスを最新の情報に更新) を選択します。

[Image Lists - Refresh Search Index](イメージリスト - インデックスを最新の情報に更新) ページが開きます。
API テストコンソールを開く場合、実際の場所を最もよく表しているリージョンを選択します。

[Image Lists - Refresh Search Index](イメージリスト - インデックスを最新の情報に更新) API コンソールが開きます。
[listId] ボックスに、リスト ID を入力します。サブスクリプションキーを入力して、[送信] を選択します。

イメージリストを作成する

Image List Management API リファレンスに移動します。

[Image Lists - Create](イメージリスト - 作成) ページが開きます。
API テストコンソールを開く場合、実際の場所を最もよく表しているリージョンを選択します。

[Image Lists - Create](イメージリスト - 作成) API コンソールが開きます。
[Ocp-Apim-Subscription-Key] ボックスにサブスクリプションキーを入力します。
[要求本文] ボックスで、[名前] (たとえば「MyList」) と [説明] の値を入力します。
よりわかりやすいメタデータをリストに割り当てるには、キーと値のペアのプレースホルダーを使用します。
```
{
    "Name": "MyExclusionList",
    "Description": "MyListDescription",
    "Metadata": 
    {
        "Category": "Competitors",
        "Type": "Exclude"
    }
}
```
リストのメタデータは、実際のイメージではなく、キーと値のペアとして追加します。
[Send] を選択します。リストが作成されました。新しいリストに関連付けられている ID の値をメモします。この ID は、他のイメージリスト管理機能で必要になります。
次に、MyList にイメージを追加します。左側のメニューで [イメージ] を選択し、[イメージの追加] を選択します。

[Image - Add Image](イメージ - イメージの追加) ページが開きます。
API テストコンソールを開く場合、実際の場所を最もよく表しているリージョンを選択します。

[Image - Add Image](イメージ - イメージの追加) API コンソールが開きます。
[listId] ボックスに生成されたリスト ID を入力し、追加するイメージの URL を入力します。サブスクリプションキーを入力して、[送信] を選択します。
イメージがリストに追加されたことを確認するには、左側のメニューで [イメージ] を選択し、[Get All Image Ids](すべてのイメージ ID を取得) を選択します。

[Image - Get All Image Ids](イメージ - すべてのイメージ ID を取得) API コンソールが開きます。
[listId] ボックスで、リスト ID を入力し、サブスクリプションキーを入力します。 [Send] を選択します。
さらにいくつかのイメージを追加します。これでカスタムイメージリストを作成できたので、カスタムイメージリストを使用してイメージを評価してみましょう。

イメージとリストを削除する

イメージやリストを削除するのは簡単です。 API を使用して、次のタスクを実行できます。

イメージを削除します。 ([Image - Delete](イメージ - 削除))
リストを削除せずに、リスト内のすべてのイメージを削除する。 ([Image - Delete All Images](イメージ - すべてのイメージを削除))
リストと、そのコンテンツをすべて削除する。 ( [Image Lists - Delete](イメージリスト - 削除) )

この例では、1 つのイメージだけを削除します。

Image List Management API リファレンスの左側のメニューで、[イメージ] を選択し、[削除] を選択します。

[Image - Delete](イメージ - 削除) ページが開きます。
API テストコンソールを開く場合、実際の場所を最もよく表しているリージョンを選択します。

[Image - Delete](イメージ - 削除) API コンソールが開きます。
[listId] ボックスに、削除するイメージが含まれるリストの ID を入力します。これは、MyList の [Image - Get All Image Ids](イメージ - すべてのイメージ ID を取得) コンソールで返される数値です。次に、削除するイメージの ImageId を入力します。

この例では、リスト ID は ContentSource の値である 58953 です。イメージ ID は ContentIds の値である 59021 です。

サブスクリプションキーを入力して、[送信] を選択します。
イメージが削除されたことを確認するには、[Image - Get All Image Ids](イメージ - すべてのイメージ ID を取得) コンソールを使用します。

リストの情報を変更する

リストの名前と説明を編集し、メタデータ項目を追加することができます。

Image List Management API リファレンスの左側のメニューで、[Image Lists](イメージリスト) を選択し、[Update Details](詳細の更新) を選択します。

[Image Lists - Update Details](イメージリスト - 詳細の更新) ページが開きます。
API テストコンソールを開く場合、実際の場所を最もよく表しているリージョンを選択します。

[Image Lists - Update Details](イメージリスト - 詳細の更新) API コンソールが開きます。
[listId] ボックスで、リスト ID を入力し、サブスクリプションキーを入力します。
[要求本文] ボックスで編集を行い、ページ上の [送信] ボタンを選択します。

次のステップ

コード内で REST API を使用するか、イメージリストに関する .NET のクイックスタートから開始して、アプリケーションと統合します。

API コンソールでカスタム イメージ リストを使用してモデレートする