LargeFaceListOperations クラス
LargeFaceListOperations 操作。
このクラスを直接インスタンス化するのではなく、それを作成して属性としてアタッチするクライアント インスタンスを作成する必要があります。
- 継承
-
builtins.objectLargeFaceListOperations
コンストラクター
LargeFaceListOperations(client, config, serializer, deserializer)
パラメーター
- client
サービス要求のクライアント。
- config
サービス クライアントの構成。
- serializer
オブジェクト モデル シリアライザー。
- deserializer
オブジェクト モデル逆シリアライザー。
メソッド
add_face_from_stream |
指定された大規模顔リストに顔を追加します (最大 1,000,000 個)。
|
add_face_from_url |
指定された大規模顔リストに顔を追加します (最大 1,000,000 個)。
|
create |
ユーザー指定の largeFaceListId、name、および省略可能な userData と recognitionModel を使用して空の大規模顔リストを作成します。
|
delete |
指定された大規模顔リストを削除します。 |
delete_face |
指定された largeFaceListId と persistedFaceId に基づいて大規模顔リストから顔を削除します。
|
get |
大規模顔リストの largeFaceListId、name、userData、recognitionModel を取得します。 |
get_face |
永続化された顔 (persistedFaceId とその属する largeFaceListId で指定) に関する情報を取得します。 |
get_training_status |
大きな顔リスト (完了または進行中) のトレーニング状態を取得します。 |
list |
largeFaceListId、name、userData、recognitionModel の大きな顔リストの情報を一覧表示します。
|
list_faces |
大きな顔リスト内のすべての顔を一覧表示し、顔情報 (顔の登録された顔の userData と persistedFaceIds を含む) を取得します。 |
train |
大きな顔リストトレーニングタスクをキューに入れます。トレーニングタスクはすぐには開始されない場合があります。 |
update |
大きな顔リストの情報を更新します。 |
update_face |
永続化された顔の userData フィールドを更新します。 |
add_face_from_stream
指定された大規模顔リストに顔を追加します (最大 1,000,000 個)。
画像に複数の顔が含まれている場合に対処するには、入力面を targetFace 四角形を持つイメージとして指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
LargeFaceList Face - Delete または LargeFaceList - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに格納されます。
メモ persistedFaceId は、[Face] によって生成された faceId とは異なります
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl)。
- 顔の画質が高いほど、認識精度が向上します。 前面、透明、顔サイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質な顔を検討してください。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。 許可されるイメージ ファイルのサイズは 1 KB から 6 MB です。
- "targetFace" 四角形には 1 つの顔が含まれている必要があります。 ゼロまたは複数の顔はエラーと見なされます。 指定された "targetFace" 四角形が Face - Detect から返されない場合、顔を検出して正常に追加する保証はありません。
- 検出可能な顔サイズ (36 x 36 ~ 4096 x 4096 ピクセル)、大きな頭部姿勢、または大きなオクルージョンが原因でエラーが発生します。
- 同じ顔リストとの間で顔を追加または削除すると、順番に処理され、異なる顔リストとの間で並行して処理されます。
- 検出可能な顔の最小サイズは、1920x1080 ピクセル以下の画像では 36 x 36 ピクセルです。 サイズが 1920 x 1080 ピクセルを超える画像では、顔の最小サイズが比例して大きくなります。
- さまざまな 'detectionModel' 値を指定できます。 さまざまな検出モデルを使用して比較するには、「 検出モデルを指定する方法」を参照してください。 Quota:
- Free レベルのサブスクリプション クォータ: 大きな顔リストあたり 1,000 顔。
- S0 レベルのサブスクリプション クォータ: 大きな顔リストあたり 1,000,000 顔。
add_face_from_stream(large_face_list_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)
パラメーター
"targetFace=left,top,width,height" の形式で人物に追加する対象の顔を指定する顔の四角形。 例: "targetFace=10,10,100,100" 画像に複数の顔がある場合は、追加する顔を指定するために targetFace が必要です。 targetFace は、画像全体で検出された顔が 1 つだけであることを意味します。
- detection_model
- str または DetectionModel
検出モデルの名前。 検出モデルは、送信された画像内の顔を検出するために使用されます。 検出モデル名は、Face - Detect または (Large)FaceList - Add Face or (Large)PersonGroup - Add Face を実行するときに指定できます。 既定値は 'detection_01' です。別のモデルが必要な場合は、明示的に指定してください。 使用できる値は、'detection_01'、'detection_02'、'detection_03' です。
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
を指定すると、ストリーミングされるデータの各チャンクで が呼び出されます。 コールバックは、現在のデータ チャンクと応答オブジェクトのバイトである 2 つの引数を受け取る必要があります。 データがアップロードされている場合、応答は None になります。
- operation_config
操作の構成がオーバーライドされます。
戻り値
persistedFace または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
add_face_from_url
指定された大規模顔リストに顔を追加します (最大 1,000,000 個)。
画像に複数の顔が含まれている場合に対処するには、入力面を targetFace 四角形を持つイメージとして指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
LargeFaceList Face - Delete または LargeFaceList - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに格納されます。
メモ persistedFaceId は、[Face] によって生成された faceId とは異なります
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl)。
- 顔の画質が高いほど、認識精度が向上します。 前面、透明、顔サイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質な顔を検討してください。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。 許可されるイメージ ファイルのサイズは 1 KB から 6 MB です。
- "targetFace" 四角形には 1 つの顔が含まれている必要があります。 ゼロまたは複数の顔はエラーと見なされます。 指定された "targetFace" 四角形が Face - Detect から返されない場合、顔を検出して正常に追加する保証はありません。
- 検出可能な顔サイズ (36 x 36 ~ 4096 x 4096 ピクセル)、大きな頭部姿勢、または大きなオクルージョンが原因でエラーが発生します。
- 同じ顔リストとの間で顔を追加または削除すると、順番に処理され、異なる顔リストとの間で並行して処理されます。
- 検出可能な顔の最小サイズは、1920x1080 ピクセル以下の画像では 36 x 36 ピクセルです。 サイズが 1920 x 1080 ピクセルを超える画像では、顔の最小サイズが比例して大きくなります。
- さまざまな 'detectionModel' 値を指定できます。 さまざまな検出モデルを使用して比較するには、「検出 モデルクォータを指定する方法 」を参照してください。
- Free レベルのサブスクリプション クォータ: 大きな顔リストあたり 1,000 顔。
- S0 レベルのサブスクリプション クォータ: 大きな顔リストあたり 1,000,000 顔。
add_face_from_url(large_face_list_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)
パラメーター
"targetFace=left,top,width,height" の形式で人物に追加する対象の顔を指定する顔の四角形。 例: "targetFace=10,10,100,100" 画像に複数の顔がある場合は、追加する顔を指定するために targetFace が必要です。 targetFace は、画像全体で検出された顔が 1 つだけであることを意味します。
- detection_model
- str または DetectionModel
検出モデルの名前。 検出モデルは、送信された画像内の顔を検出するために使用されます。 検出モデル名は、Face - Detect または (Large)FaceList - Add Face or (Large)PersonGroup - Add Face を実行するときに指定できます。 既定値は 'detection_01' です。別のモデルが必要な場合は、明示的に指定してください。 使用できる値は、'detection_01'、'detection_02'、'detection_03' です。
- operation_config
操作の構成がオーバーライドされます。
戻り値
persistedFace または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
create
ユーザー指定の largeFaceListId、name、および省略可能な userData と recognitionModel を使用して空の大規模顔リストを作成します。
大きな顔リストは、最大 1,000,000 個の顔の一覧であり、 Face - Find Similar で使用されます。
作成後、ユーザーは LargeFaceList Face - Add を使用して顔をインポートし、 LargeFaceList - Train を使用して Face - Find Similar の準備を整える必要があります。
イメージは保存されません。 LargeFaceList - Delete が呼び出されるまで、抽出された顔の特徴のみがサーバーに格納されます。
類似の検索は、有名人のような顔の検索、似た顔のフィルター処理、または明るい方法での顔識別などのシナリオに使用されます。
ただし、実際に個人を識別する場合は、PersonGroupLargePersonGroup
/
と Face - Identify を使用してください。
この大きな顔リストに関連付けるには、'recognitionModel' を指定する必要があります。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。 既存の大きな顔リストに追加された新しい顔は、コレクションに既に関連付けられている認識モデルを使用します。 大きな顔リスト内の既存の顔の特徴を、別のバージョンの認識モデルによって抽出された特徴に更新することはできません。 「認識モデルを指定する」を参照してください。
顔リストのクォータが大きい:
- Free レベルのサブスクリプション クォータ: 64 個の大きな顔リスト。
- S0 レベルのサブスクリプション クォータ: 1,000,000 個の大きな顔リスト。
create(large_face_list_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)
パラメーター
- recognition_model
- str または RecognitionModel
使用できる値は、'recognition_01'、'recognition_02'、'recognition_03'、'recognition_04' です。
- operation_config
操作の構成がオーバーライドされます。
戻り値
raw=true の場合は None または ClientRawResponse
の戻り値の型 :
例外
delete
指定された大規模顔リストを削除します。
delete(large_face_list_id, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
none または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
delete_face
指定された largeFaceListId と persistedFaceId に基づいて大規模顔リストから顔を削除します。
同じ大きな顔リストとの間で顔を追加/削除すると、順番に処理され、異なる大きな顔リストとの間で並列に処理されます。
delete_face(large_face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
none または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
get
大規模顔リストの largeFaceListId、name、userData、recognitionModel を取得します。
get(large_face_list_id, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
raw=true の場合は LargeFaceList または ClientRawResponse
の戻り値の型 :
例外
get_face
永続化された顔 (persistedFaceId とその属する largeFaceListId で指定) に関する情報を取得します。
get_face(large_face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
persistedFace または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
get_training_status
大きな顔リスト (完了または進行中) のトレーニング状態を取得します。
get_training_status(large_face_list_id, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
TrainingStatus または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
list
largeFaceListId、name、userData、recognitionModel の大きな顔リストの情報を一覧表示します。
largeFaceList 内の顔情報を取得するには、LargeFaceList Face - Get を使用します
- 大きな顔リストは、largeFaceListId のアルファベット順に格納されます。
- "start" パラメーター (string, optional) は、文字列比較によって返されるエントリの ID が大きい、ユーザー指定の largeFaceListId 値です。 "start" は空に設定され、最初の項目からの戻り値を示します。
- "top" パラメーター (int, optional) は、返されるエントリの数を指定します。 最大 1000 エントリを 1 回の呼び出しで返すことができます。 さらにフェッチするには、現在の呼び出しの最後に返されたエントリの ID で "start" を指定できます。
たとえば、"list1"、...、"list5" の合計 5 つの大きなユーザー リストです。
"start=&top=" は 5 つのリストをすべて返します。
"start=&top=2" は "list1"、"list2" を返します。
"start=list2&top=3" は "list3"、"list4"、"list5" を返します。 .
list(return_recognition_model=False, start=None, top=None, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
list または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
list_faces
大きな顔リスト内のすべての顔を一覧表示し、顔情報 (顔の登録された顔の userData と persistedFaceIds を含む) を取得します。
list_faces(large_face_list_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
list または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
train
大きな顔リストトレーニングタスクをキューに入れます。トレーニングタスクはすぐには開始されない場合があります。
train(large_face_list_id, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
none または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
update
大きな顔リストの情報を更新します。
update(large_face_list_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
none または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
update_face
永続化された顔の userData フィールドを更新します。
update_face(large_face_list_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)
パラメーター
- operation_config
操作構成のオーバーライド。
戻り値
none または ClientRawResponse (raw=true の場合)
の戻り値の型 :
例外
属性
models
models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>
Azure SDK for Python
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示