PersonGroupPersonOperations クラス
PersonGroupPersonOperations 操作。
このクラスを直接インスタンス化するのではなく、それを作成して属性としてアタッチするクライアント インスタンスを作成する必要があります。
- 継承
-
builtins.objectPersonGroupPersonOperations
コンストラクター
PersonGroupPersonOperations(client, config, serializer, deserializer)
パラメーター
名前 | 説明 |
---|---|
client
必須
|
サービス要求のクライアント。 |
config
必須
|
サービス クライアントの構成。 |
serializer
必須
|
オブジェクト モデル シリアライザー。 |
deserializer
必須
|
オブジェクト モデル逆シリアライザー。 |
メソッド
add_face_from_stream |
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
|
add_face_from_url |
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
|
create |
指定された人物グループに新しい人物を作成します。 |
delete |
人物グループから既存の人物を削除します。 person エントリの persistedFaceId、userData、person name、face 機能はすべて削除されます。 |
delete_face |
指定された personGroupId、personId および persistedFaceId に基づいて人物グループの人物から顔を削除します。
|
get |
登録された永続化された顔、名前、userData など、ユーザーの情報を取得します。 |
get_face |
永続化された顔 (persistedFaceId、personId、およびその属する personGroupId で指定) に関する情報を取得します。 |
list |
ユーザー グループ内のすべてのユーザーを一覧表示し、個人情報 (personId、名前、userData、およびユーザーの登録済み顔の persistedFaceIds を含む) を取得します。 |
update |
人物の name または userData を更新します。 |
update_face |
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
|
add_face_from_stream
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
メモ persistedFaceId は、[Face] によって生成された faceId とは異なります
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl)。
- 顔の画質が高いほど、認識精度が向上します。 正面、透明、顔のサイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質の顔を検討してください。
- 各人のエントリには、最大 248 の顔を保持できます。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。 許可されるイメージ ファイルのサイズは 1 KB から 6 MB です。
- "targetFace" 四角形には、1 つの顔が含まれている必要があります。 0 個または複数の面はエラーと見なされます。 指定された "targetFace" 四角形が Face - Detect から返されない場合、顔を正常に検出して追加する保証はありません。
- 検出可能な顔サイズ (36 x 36 ~ 4096 x 4096 ピクセル)、大きな頭部姿勢、または大きなオクルージョンが原因でエラーが発生します。
- 同じ人物に対して顔を追加または削除すると、順番に処理されます。 異なる人に対する顔の追加/削除は、並行して処理されます。
- 検出可能な顔の最小サイズは、1920x1080 ピクセル以下の画像では 36 x 36 ピクセルです。 1920x1080 ピクセルより大きいサイズの画像では、顔の最小サイズが比例的に大きくなります。
- さまざまな 'detectionModel' 値を指定できます。 さまざまな検出モデルを使用して比較するには、「 検出モデルを指定する方法」を参照してください。
add_face_from_stream(person_group_id, person_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
image
必須
|
イメージ ストリーム。 |
user_data
|
任意の目的で顔に関するユーザー指定のデータ。 最大長は 1 KB です。 既定値: None
|
target_face
|
"targetFace=left,top,width,height" の形式でユーザーに追加する対象の顔を指定する顔の四角形。 例: "targetFace=10,10,100,100" イメージに複数の顔がある場合は、追加する顔を指定するために targetFace が必要です。 targetFace は、画像全体で検出された顔が 1 つだけであることを意味します。 既定値: None
|
detection_model
|
str または
DetectionModel
検出モデルの名前。 検出モデルは、送信された画像内の顔を検出するために使用されます。 検出モデル名は、Face - Detect または (Large)FaceList - Add Face or (Large)PersonGroup - Add Face を実行するときに指定できます。 既定値は 'detection_01' です。別のモデルが必要な場合は、明示的に指定してください。 指定できる値は、'detection_01'、'detection_02'、'detection_03' です。 既定値: detection_01
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
callback
|
Callable[<xref:Bytes>, <xref:response=None>]
を指定すると、ストリーミングされるデータの各チャンクで が呼び出されます。 コールバックは、データの現在のチャンクのバイトと応答オブジェクトの 2 つの引数を受け取る必要があります。 データがアップロードされている場合、応答は None になります。 既定値: None
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
persistedFace または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
add_face_from_url
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
メモ persistedFaceId は、[Face] によって生成された faceId とは異なります
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl)。
- 顔の画質が高いほど、認識精度が向上します。 正面、透明、顔のサイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質の顔を検討してください。
- 各人のエントリには、最大 248 の顔を保持できます。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。 許可されるイメージ ファイルのサイズは 1 KB から 6 MB です。
- "targetFace" 四角形には、1 つの顔が含まれている必要があります。 0 個または複数の面はエラーと見なされます。 指定された "targetFace" 四角形が Face - Detect から返されない場合、顔を正常に検出して追加する保証はありません。
- 検出可能な顔サイズ (36 x 36 ~ 4096 x 4096 ピクセル)、大きな頭部姿勢、または大きなオクルージョンが原因でエラーが発生します。
- 同じ人物に対して顔を追加または削除すると、順番に処理されます。 異なる人に対する顔の追加/削除は、並行して処理されます。
- 検出可能な顔の最小サイズは、1920x1080 ピクセル以下の画像では 36 x 36 ピクセルです。 1920x1080 ピクセルより大きいサイズの画像では、顔の最小サイズが比例的に大きくなります。
- さまざまな 'detectionModel' 値を指定できます。 さまざまな検出モデルを使用して比較するには、「 検出モデルを指定する方法」を参照してください。
add_face_from_url(person_group_id, person_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
url
必須
|
イメージのパブリックに到達可能な URL |
user_data
|
任意の目的で顔に関するユーザー指定のデータ。 最大長は 1 KB です。 既定値: None
|
target_face
|
"targetFace=left,top,width,height" の形式でユーザーに追加する対象の顔を指定する顔の四角形。 例: "targetFace=10,10,100,100" イメージに複数の顔がある場合は、追加する顔を指定するために targetFace が必要です。 targetFace は、画像全体で検出された顔が 1 つだけであることを意味します。 既定値: None
|
detection_model
|
str または
DetectionModel
検出モデルの名前。 検出モデルは、送信された画像内の顔を検出するために使用されます。 検出モデル名は、Face - Detect または (Large)FaceList - Add Face or (Large)PersonGroup - Add Face を実行するときに指定できます。 既定値は 'detection_01' です。別のモデルが必要な場合は、明示的に指定してください。 指定できる値は、'detection_01'、'detection_02'、'detection_03' です。 既定値: detection_01
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
persistedFace または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
create
指定された人物グループに新しい人物を作成します。
create(person_group_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
name
|
ユーザー定義名、最大長は 128 です。 既定値: None
|
user_data
|
ユーザー指定のデータ。 長さは 16 KB を超えないようにしてください。 既定値: None
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
person または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
delete
人物グループから既存の人物を削除します。 person エントリの persistedFaceId、userData、person name、face 機能はすべて削除されます。
delete(person_group_id, person_id, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
none または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
delete_face
指定された personGroupId、personId および persistedFaceId に基づいて人物グループの人物から顔を削除します。
同じ人物に対して顔を追加または削除すると、順番に処理されます。 異なる人に対する顔の追加/削除は、並行して処理されます。
delete_face(person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
persisted_face_id
必須
|
既存の顔の特定の persistedFaceId を参照する ID。 |
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
none または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
get
登録された永続化された顔、名前、userData など、ユーザーの情報を取得します。
get(person_group_id, person_id, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
person または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
get_face
永続化された顔 (persistedFaceId、personId、およびその属する personGroupId で指定) に関する情報を取得します。
get_face(person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
persisted_face_id
必須
|
既存の顔の特定の persistedFaceId を参照する ID。 |
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
persistedFace または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
list
ユーザー グループ内のすべてのユーザーを一覧表示し、個人情報 (personId、名前、userData、およびユーザーの登録済み顔の persistedFaceIds を含む) を取得します。
list(person_group_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
start
|
返す開始ユーザー ID (ユーザーの範囲を一覧表示するために使用)。 既定値: None
|
top
|
'start' パラメーターで示される人物 ID で始まる、返すユーザーの数。 既定値: None
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
list または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
update
人物の name または userData を更新します。
update(person_group_id, person_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
name
|
ユーザー定義名、最大長は 128 です。 既定値: None
|
user_data
|
ユーザー指定のデータ。 長さは 16 KB を超えないようにしてください。 既定値: None
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
none または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
update_face
顔識別または顔検証のために、人物の顔を人物グループに追加します。 複数の顔を含む画像を処理するには、入力面を targetFace 四角形を含む画像として指定できます。 追加された顔を表す persistedFaceId を返します。 イメージは保存されません。
PersonGroup PersonFace - Delete、PersonGroup Person - Delete、または PersonGroup - Delete が呼び出されるまで、抽出された顔機能のみがサーバーに保存されます。
メモ persistedFaceId は、[Face] によって生成された faceId とは異なります
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl)。
- 顔の画質が高いほど、認識精度が向上します。 正面、透明、顔のサイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質の顔を検討してください。
- 各人のエントリには、最大 248 の顔を保持できます。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。 許可されるイメージ ファイルのサイズは 1 KB から 6 MB です。
- "targetFace" 四角形には、1 つの顔が含まれている必要があります。 0 個または複数の面はエラーと見なされます。 指定された "targetFace" 四角形が Face - Detect から返されない場合、顔を正常に検出して追加する保証はありません。
- 検出可能な顔サイズ (36 x 36 ~ 4096 x 4096 ピクセル)、大きな頭部姿勢、または大きなオクルージョンが原因でエラーが発生します。
- 同じ人物に対して顔を追加または削除すると、順番に処理されます。 異なる人に対する顔の追加/削除は、並行して処理されます。
update_face(person_group_id, person_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)
パラメーター
名前 | 説明 |
---|---|
person_group_id
必須
|
特定のユーザー グループを参照する ID。 |
person_id
必須
|
特定のユーザーを参照している ID。 |
persisted_face_id
必須
|
既存の顔の特定の persistedFaceId を参照する ID。 |
user_data
|
顔にアタッチされたユーザー指定のデータ。 サイズ制限は 1 KB です。 既定値: None
|
custom_headers
|
要求に追加されるヘッダー 既定値: None
|
raw
|
は、逆シリアル化された応答と共に直接応答を返します 既定値: False
|
operation_config
必須
|
操作構成のオーバーライド。 |
戻り値
型 | 説明 |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
none または ClientRawResponse (raw=true の場合) |
例外
型 | 説明 |
---|---|
属性
models
models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>
Azure SDK for Python
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示