Person Group Operations - Create Large Person Group

ユーザー指定の largePersonGroupId、名前、省略可能な userData、recognitionModel を使用して、新しい Large Person グループを作成します。
大規模人物グループは、顔認識機能を含む、アップロードされた人物データを保持するコンテナーです。 最大 1,000,000 個のエンティティを保持できます。

作成後、"大規模人物グループユーザーの作成" を使用してグループにユーザーを追加し、"大規模人物グループのトレーニング" を呼び出して、このグループを "大規模なユーザー グループから識別" の準備をします。

イメージは保存されません。 ユーザーの抽出された顔機能と userData のみが、"Delete Large Person Group Person" または "Delete Large Person Group" が呼び出されるまでサーバーに格納されます。

この大規模人物グループに関連付けるには、'recognitionModel' を指定する必要があります。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。 既存の大規模人物グループに追加された新しい顔は、コレクションに既に関連付けられている認識モデルを使用します。 大規模人物グループ内の既存の顔特徴を、別のバージョンの認識モデルによって抽出された特徴に更新することはできません。

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

URI パラメーター

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

Azure AI Face サブスクリプションの秘密鍵。

型: apiKey
/: header

AADToken

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://api.example.com/oauth2/authorize
Token URL (トークン URL): https://api.example.com/oauth2/token

スコープ

例

Create LargePersonGroup

PUT {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

定義

FaceError

エラー オブジェクト。 Face サービスによって返されるエラー コードとメッセージの詳細については、次のリンクを参照してください: https://aka.ms/face-error-codes-and-messages。

FaceErrorResponse

エラーの詳細を含む応答。