フェイスAPI (顔認識API)
Microsoft Cognitive Services Face API を使用すると、写真内の顔を検出、識別、分析、整理、タグ付けできます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | すべての地域 Power Automate |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | Standard | すべての Power Apps リージョン |
| Power Automate | Standard | すべての地域 Power Automate |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Web サイト | https://azure.microsoft.com/services/cognitive-services/face/ |
この統合を使用するには、Azure portal で Cognitive Service リソース が必要です。 アプリケーションを認証するためのエンドポイントとキーを取得します。 接続するには、アカウント キーとサイト URL を指定し、[接続の 作成] を選択します。 接続の操作コストについては、 こちらをご覧ください。
これで、この統合の使用を開始する準備ができました。
Microsoft Entra ID を使用した接続
Microsoft Entra ID を使用して接続を作成するには、アクセスするアカウントに Cognitive Services ユーザー ロールを追加する必要があります。 この接続を使用するには、Cognitive Services リソースに関連付けられている一意のサブドメインをサポート操作に入力する必要があります。
Microsoft Entra ID 認証ではサポートされていない操作
Microsoft Entra ID 認証を使用する場合 、V2 アクションのみがサポートされます。 非推奨のアクションは引き続き Access Key 認証で動作しますが、 Microsoft Entra ID 接続で使用すると失敗します。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| API キー | API キー | すべてのリージョン | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
API キー
認証 ID: keyBasedAuth
適用対象: すべてのリージョン
API キー
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| アカウント キー | securestring | Cognitive Services アカウント キー | |
| サイトの URL | 文字列 | ルート サイトの URL (例: https://westus.api.cognitive.microsoft.com) |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | API キー | 正しい |
| サイトの URL | 文字列 | ルート サイトの URL (例: https://westus.api.cognitive.microsoft.com )。指定されていない場合、サイトの URL は既定で "https://westus.api.cognitive.microsoft.com" に設定されます。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| ユーザー グループを作成する |
指定した personGroupId、名前、ユーザー指定の userData を使用して、新しいユーザー グループを作成します。 |
| ユーザー グループを作成する (V2) |
指定した personGroupId、名前、ユーザー指定の userData を使用して、新しいユーザー グループを作成します。 |
| ユーザー グループを取得する |
ユーザー グループの名前や userData などの情報を取得します。 |
| ユーザー グループを取得する (V2) |
ユーザー グループの名前や userData などの情報を取得します。 |
| ユーザーの作成 (V2) |
指定したユーザー グループに新しいユーザーを作成します。 |
| ユーザーを作成する |
指定したユーザー グループに新しいユーザーを作成します。 |
| ユーザーを取得する |
登録済みの永続化された顔、名前、userData など、ユーザーの情報を取得します。 |
| ユーザーを取得する (V2) |
登録済みの永続化された顔、名前、userData など、ユーザーの情報を取得します。 |
| 人の顔を取得する |
persistedFaceId、personId、およびその属する personGroupId によって指定された永続化された顔に関する情報を取得します。 |
| 人の顔を取得する (V2) |
persistedFaceId、personId、およびその属する personGroupId によって指定された永続化された顔に関する情報を取得します。 |
| 人物の顔を追加する |
識別のために担当者に代表的な顔を追加します。 |
| 人物顔を追加する (V2) |
識別のために担当者に代表的な顔を追加します。 |
| 顔から人を検索する (V2) |
2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が 1 人の人物に属しているかどうかを確認します。 |
| 顔から人を見つける |
2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が 1 人の人物に属しているかどうかを確認します。 |
| 顔を検出する |
画像内の人間の顔を検出し、顔の位置を返します。必要に応じて、faceId、ランドマーク、属性を使用します。 |
| 顔を検出する (V2) |
画像内の人間の顔を検出し、顔の位置を返します。必要に応じて、faceId、ランドマーク、属性を使用します。 |
| 顔リストに顔を追加する |
顔一覧に顔を追加します。 |
| 顔リストを作成する |
ユーザー指定の faceListId、name、および省略可能な userData を含む空の顔リストを作成します。 |
| 顔リストを作成する (V2) |
ユーザー指定の faceListId、name、および省略可能な userData を含む空の顔リストを作成します。 |
| 顔リストを取得する |
faceListId、名前、userData、顔リスト内の顔など、顔リストの情報を取得します。 |
| 顔リストを取得する (V2) |
faceListId、名前、userData、顔リスト内の顔など、顔リストの情報を取得します。 |
| 顔一覧に顔を追加する (V2) |
顔一覧に顔を追加します。 |
ユーザー グループを作成する
指定した personGroupId、名前、ユーザー指定の userData を使用して、新しいユーザー グループを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
新しい人物グループ ID (有効な文字には、数字、小文字の英字、'-' と '_' が含まれます) |
|
名前
|
name | True | string |
ユーザー グループの表示名。 最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
ユーザーグループにアタッチされたユーザー指定のデータ。 サイズ制限は 16 KB です。 |
ユーザー グループを作成する (V2)
指定した personGroupId、名前、ユーザー指定の userData を使用して、新しいユーザー グループを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
新しい人物グループ ID (有効な文字には、数字、小文字の英字、'-' と '_' が含まれます) |
|
名前
|
name | True | string |
ユーザー グループの表示名。 最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
ユーザーグループにアタッチされたユーザー指定のデータ。 サイズ制限は 16 KB です。 |
ユーザー グループを取得する
ユーザー グループの名前や userData などの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
ターゲット ユーザー グループ ID。 |
戻り値
ユーザー グループを取得する (V2)
ユーザー グループの名前や userData などの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
ターゲット ユーザー グループ ID。 |
戻り値
ユーザーの作成 (V2)
指定したユーザー グループに新しいユーザーを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
ユーザーを作成する対象ユーザー グループを指定します。 |
|
名前
|
name | True | string |
対象ユーザーの表示名。 最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
ユーザーに添付されたユーザー指定のデータのオプション フィールド。 サイズ制限は 16 KB です。 |
戻り値
- Body
- CreatePersonResponse
ユーザーを作成する
指定したユーザー グループに新しいユーザーを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
ユーザーを作成する対象ユーザー グループを指定します。 |
|
名前
|
name | True | string |
対象ユーザーの表示名。 最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
ユーザーに添付されたユーザー指定のデータのオプション フィールド。 サイズ制限は 16 KB です。 |
戻り値
- Body
- CreatePersonResponse
ユーザーを取得する
登録済みの永続化された顔、名前、userData など、ユーザーの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
対象ユーザーを含むユーザー グループを指定します。 |
|
人物 ID
|
personId | True | string |
対象のユーザーを指定します。 |
戻り値
- Body
- GetPersonResponse
ユーザーを取得する (V2)
登録済みの永続化された顔、名前、userData など、ユーザーの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
対象ユーザーを含むユーザー グループを指定します。 |
|
人物 ID
|
personId | True | string |
対象のユーザーを指定します。 |
戻り値
- Body
- GetPersonResponse
人の顔を取得する
persistedFaceId、personId、およびその属する personGroupId によって指定された永続化された顔に関する情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
対象ユーザーを含むユーザー グループを指定します。 |
|
人物 ID
|
personId | True | string |
顔が属する対象ユーザーを指定します。 |
|
永続化された顔 ID
|
persistedFaceId | True | string |
ユーザーの対象の永続化された顔の persistedFaceId。 |
戻り値
人の顔を取得する (V2)
persistedFaceId、personId、およびその属する personGroupId によって指定された永続化された顔に関する情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
対象ユーザーを含むユーザー グループを指定します。 |
|
人物 ID
|
personId | True | string |
顔が属する対象ユーザーを指定します。 |
|
永続化された顔 ID
|
persistedFaceId | True | string |
ユーザーの対象の永続化された顔の persistedFaceId。 |
戻り値
人物の顔を追加する
識別のために担当者に代表的な顔を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物グループ ID
|
personGroupId | True | string |
人物グループ |
|
人物 ID
|
personId | True | string |
顔が追加されるターゲットユーザー。 |
|
イメージ URL
|
url | True | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
|
ターゲットフェイス
|
targetFace | string |
targetFace=left、top、width、height の形式で、ユーザーに追加する対象の顔を指定する顔の四角形 |
|
|
ユーザー データ
|
userData | string |
任意の目的で追加する対象の顔に関するユーザー指定のデータ。 最大長は 1 KB です。 |
戻り値
人物顔を追加する (V2)
識別のために担当者に代表的な顔を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
人物グループ ID
|
personGroupId | True | string |
人物グループ |
|
人物 ID
|
personId | True | string |
顔が追加されるターゲットユーザー。 |
|
イメージ URL
|
url | True | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
|
ターゲットフェイス
|
targetFace | string |
targetFace=left、top、width、height の形式で、ユーザーに追加する対象の顔を指定する顔の四角形 |
|
|
ユーザー データ
|
userData | string |
任意の目的で追加する対象の顔に関するユーザー指定のデータ。 最大長は 1 KB です。 |
戻り値
顔から人を検索する (V2)
2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が 1 人の人物に属しているかどうかを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
Face Id
|
faceId | True | string |
検出された顔の一意の faceId。 検出呼び出しの 24 時間後に有効期限が切れます。 |
|
人物グループ ID
|
personGroupId | True | string |
Face API で作成された人物グループ ID - 人物グループの作成アクション。 |
|
人物 ID
|
personId | True | string |
Face API で作成された人物 ID - 人物の作成アクション。 |
戻り値
- Body
- VerifyResponse
顔から人を見つける
2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が 1 人の人物に属しているかどうかを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Face Id
|
faceId | True | string |
検出された顔の一意の faceId。 検出呼び出しの 24 時間後に有効期限が切れます。 |
|
人物グループ ID
|
personGroupId | True | string |
Face API で作成された人物グループ ID - 人物グループの作成アクション。 |
|
人物 ID
|
personId | True | string |
Face API で作成された人物 ID - 人物の作成アクション。 |
戻り値
- Body
- VerifyResponse
顔を検出する
画像内の人間の顔を検出し、顔の位置を返します。必要に応じて、faceId、ランドマーク、属性を使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イメージ URL
|
url | True | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
戻り値
- アイテム
- DetectResponse
顔を検出する (V2)
画像内の人間の顔を検出し、顔の位置を返します。必要に応じて、faceId、ランドマーク、属性を使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
イメージ URL
|
url | True | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
戻り値
- アイテム
- DetectResponse
顔リストに顔を追加する
顔一覧に顔を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イメージ URL
|
url | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
|
|
ターゲットフェイス
|
targetFace | string |
targetFace=left、top、width、height の形式で、ユーザーに追加する対象の顔を指定する顔の四角形 |
|
|
ユーザー データ
|
userData | string |
任意の目的で追加する対象の顔に関するユーザー指定のデータ。 最大長は 1 KB です。 |
|
|
Face List Id
|
faceListId | True | string |
有効な文字は、小文字または数字、または「-」または「_」で、最大長は64です。 |
戻り値
顔リストを作成する
ユーザー指定の faceListId、name、および省略可能な userData を含む空の顔リストを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Face List Id
|
faceListId | True | string |
有効な文字は小文字または数字、'-' または '_' の文字で、最大長は 64 です |
|
顔リスト名
|
name | True | string |
作成された顔リストの名前。最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
顔リストのオプションのユーザー定義データ。 長さは 16 KB を超えないようにしてください。 |
顔リストを作成する (V2)
ユーザー指定の faceListId、name、および省略可能な userData を含む空の顔リストを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
Face List Id
|
faceListId | True | string |
有効な文字は小文字または数字、'-' または '_' の文字で、最大長は 64 です |
|
顔リスト名
|
name | True | string |
作成された顔リストの名前。最大長は 128 です。 |
|
ユーザー データ
|
userData | string |
顔リストのオプションのユーザー定義データ。 長さは 16 KB を超えないようにしてください。 |
顔リストを取得する
faceListId、名前、userData、顔リスト内の顔など、顔リストの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Face List Id
|
faceListId | True | string |
ターゲット顔リストの faceListId。 |
戻り値
- Body
- GetFaceListResponse
顔リストを取得する (V2)
faceListId、名前、userData、顔リスト内の顔など、顔リストの情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
Face List Id
|
faceListId | True | string |
ターゲット顔リストの faceListId。 |
戻り値
- Body
- GetFaceListResponse
顔一覧に顔を追加する (V2)
顔一覧に顔を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソース サブドメインまたはリージョン
|
subdomain | True | string |
Azure サブドメインまたは地理的リージョン (westus など) |
|
イメージ URL
|
url | string |
画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります |
|
|
ターゲットフェイス
|
targetFace | string |
targetFace=left、top、width、height の形式で、ユーザーに追加する対象の顔を指定する顔の四角形 |
|
|
ユーザー データ
|
userData | string |
任意の目的で追加する対象の顔に関するユーザー指定のデータ。 最大長は 1 KB です。 |
|
|
Face List Id
|
faceListId | True | string |
有効な文字は、小文字または数字、または「-」または「_」で、最大長は64です。 |
戻り値
定義
DetectResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Face Id
|
faceId | string |
検出された顔の一意の faceId。 検出呼び出しの 24 時間後に有効期限が切れます。 |
|
上
|
faceRectangle.top | integer |
画像上の顔位置の四角形領域のパラメーター。 |
|
Left
|
faceRectangle.left | integer |
画像上の顔位置の四角形領域のパラメーター。 |
|
Width
|
faceRectangle.width | integer |
画像上の顔位置の四角形領域のパラメーター。 |
|
高さ
|
faceRectangle.height | integer |
画像上の顔位置の四角形領域のパラメーター。 |
|
左瞳孔 X
|
faceLandmarks.pupilLeft.x | float |
左瞳孔の x 座標。 |
|
左瞳 Y
|
faceLandmarks.pupilLeft.y | float |
左瞳孔の y 座標。 |
|
右瞳 X
|
faceLandmarks.pupilRight.x | float |
右瞳孔の x 座標。 |
|
右瞳 Y
|
faceLandmarks.pupilRight.y | float |
右瞳孔の y 座標。 |
|
ノーズチップX
|
faceLandmarks.noseTip.x | float |
鼻先端の x 座標。 |
|
ノーズチップY
|
faceLandmarks.noseTip.y | float |
鼻先端の y 座標。 |
|
マウス左 X
|
faceLandmarks.mouthLeft.x | float |
口の左側の x 座標。 |
|
口左 Y
|
faceLandmarks.mouthLeft.y | float |
口の左側の y 座標。 |
|
マウス右 X
|
faceLandmarks.mouthRight.x | float |
口の右側の x 座標。 |
|
口右 Y
|
faceLandmarks.mouthRight.y | float |
口の右側の y 座標。 |
|
外側左つゆ X
|
faceLandmarks.eyebrowLeftOuter.x | float |
左の眉の外側の x 座標。 |
|
外側左つゆみ Y
|
faceLandmarks.eyebrowLeftOuter.y | float |
左の眉の外側の y 座標。 |
|
内側左エイブロウ X
|
faceLandmarks.eyebrowLeftInner.x | float |
左の眉の内側の x 座標。 |
|
内側左つゆ Y
|
faceLandmarks.eyebrowLeftInner.y | float |
左の眉の内側の y 座標。 |
|
外側左目 X
|
faceLandmarks.eyeLeftOuter.x | float |
左目の外側の x 座標。 |
|
外側左目 Y
|
faceLandmarks.eyeLeftOuter.y | float |
左目の外側の y 座標。 |
|
左目の上 X
|
faceLandmarks.eyeLeftTop.x | float |
左目の上の x 座標。 |
|
左目の上 Y
|
faceLandmarks.eyeLeftTop.y | float |
左目の上の y 座標。 |
|
左目の下 X
|
faceLandmarks.eyeLeftBottom.x | float |
左目の下の x 座標。 |
|
左目の下 Y
|
faceLandmarks.eyeLeftBottom.y | float |
左目の下部の y 座標。 |
|
内側左目 X
|
faceLandmarks.eyeLeftInner.x | float |
左目の内側の x 座標。 |
|
左目内側 Y
|
faceLandmarks.eyeLeftInner.y | float |
左目の内側の y 座標。 |
|
内側右エイブロウ X
|
faceLandmarks.eyebrowRightInner.x | float |
右の眉の内側の x 座標。 |
|
内側右つゆみ Y
|
faceLandmarks.eyebrowRightInner.y | float |
右の眉の内側の y 座標。 |
|
外側右つゆ X
|
faceLandmarks.eyebrowRightOuter.x | float |
右の眉の外側の x 座標。 |
|
外側右つゆ Y
|
faceLandmarks.eyebrowRightOuter.y | float |
右の眉の外側の y 座標。 |
|
内側右目 X
|
faceLandmarks.eyeRightInner.x | float |
右目の内側の x 座標。 |
|
内側右目 Y
|
faceLandmarks.eyeRightInner.y | float |
右目の内側の y 座標。 |
|
右目の上 X
|
faceLandmarks.eyeRightTop.x | float |
右目の上の x 座標。 |
|
右目の上 Y
|
faceLandmarks.eyeRightTop.y | float |
右目の上の y 座標。 |
|
右下目 X
|
faceLandmarks.eyeRightBottom.x | float |
右目の下の x 座標。 |
|
右目の下 Y
|
faceLandmarks.eyeRightBottom.y | float |
右目の下の y 座標。 |
|
外側右目 X
|
faceLandmarks.eyeRightOuter.x | float |
右目の外側の x 座標。 |
|
外側右目 Y
|
faceLandmarks.eyeRightOuter.y | float |
右目の外側の y 座標。 |
|
左鼻根X
|
faceLandmarks.noseRootLeft.x | float |
鼻根の左側の x 座標。 |
|
左鼻根Y
|
faceLandmarks.noseRootLeft.y | float |
鼻根の左側の y 座標。 |
|
右鼻根X
|
faceLandmarks.noseRootRight.x | float |
鼻根の右側の x 座標。 |
|
右鼻根Y
|
faceLandmarks.noseRootRight.y | float |
鼻根の右側の y 座標。 |
|
左鼻の上 X
|
faceLandmarks.noseLeftAlarTop.x | float |
左鼻の聖壇の上の x 座標。 |
|
左鼻の上の仏壇 Y
|
faceLandmarks.noseLeftAlarTop.y | float |
左鼻の上の y 座標。 |
|
右鼻の上の仏壇X
|
faceLandmarks.noseRightAlarTop.x | float |
右鼻の上の聖壇のx座標。 |
|
右鼻の上の仏壇 Y
|
faceLandmarks.noseRightAlarTop.y | float |
右鼻の仏壇の上のy座標。 |
|
左鼻の先端の花壇X
|
faceLandmarks.noseLeftAlarOutTip.x | float |
左鼻の仏壇の先端の x 座標。 |
|
左鼻の先端 Y
|
faceLandmarks.noseLeftAlarOutTip.y | float |
左鼻の仏壇の先端のy座標/ |
|
右鼻の先端の花壇X
|
faceLandmarks.noseRightAlarOutTip.x | float |
右鼻の仏壇の先端の x 座標。 |
|
右鼻の先端 Y
|
faceLandmarks.noseRightAlarOutTip.y | float |
右鼻の仏壇の先端のy座標。 |
|
トップ オブ アッパー リップ X
|
faceLandmarks.upperLipTop.x | float |
上唇の上部の x 座標。 |
|
トップ オブ アッパー リップ Y
|
faceLandmarks.upperLipTop.y | float |
上唇の上の y 座標。 |
|
上唇の下 X
|
faceLandmarks.upperLipBottom.x | float |
上唇の下部の x 座標。 |
|
上唇の下 Y
|
faceLandmarks.upperLipBottom.y | float |
上唇の下部の y 座標。 |
|
トップ オブ アンダー リップ X
|
faceLandmarks.underLipTop.x | float |
下唇の上部の x 座標。 |
|
トップ オブ アンダー リップ Y
|
faceLandmarks.underLipTop.y | float |
下唇の上部の y 座標。 |
|
アンダーリップXの底
|
faceLandmarks.underLipBottom.x | float |
下唇の下部の x 座標。 |
|
アンダーリップYの底
|
faceLandmarks.underLipBottom.y | float |
下リップの下部の y 座標。 |
|
頭部姿勢ピッチ
|
faceAttributes.headPose.pitch | float |
予約済みフィールドは、常に 0 を返します。 |
|
ヘッドポーズロール
|
faceAttributes.headPose.roll | float |
●頭部のロールポーズ。 |
|
ヘッドポーズヨー
|
faceAttributes.headPose.yaw | float |
●頭部ポーズのヨー。 |
|
眼鏡
|
faceAttributes.glasses | string |
眼鏡の種類。 |
AddPersonFaceResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
永続化された顔 ID
|
persistedFaceId | string |
GetPersonGroupResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
人物グループ ID
|
personGroupId | string | |
|
名前
|
name | string | |
|
ユーザーデータ
|
userData | string |
GetFaceListResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
永続化された顔
|
persistedFaces | array of object | |
|
永続化された顔 ID
|
persistedFaces.persistedFaceId | string |
顔の ID。 |
|
ユーザー データ
|
persistedFaces.userData | string |
各顔にアタッチされたユーザー指定のデータ。 |
|
Face List Id
|
faceListId | string |
ターゲット顔リストの faceListId。 |
|
名前
|
name | string |
顔リストの表示名。 |
|
ユーザー データ
|
userData | string |
顔リストにアタッチされたユーザー指定のデータ。 |
GetPersonFaceResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
永続化された顔 ID
|
persistedFaceId | string | |
|
ユーザーデータ
|
userData | string |
CreatePersonResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
人物 ID
|
personId | string |
GetPersonResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
人物 ID
|
personId | string | |
|
永続化された顔 ID
|
persistedFaceIds | array of object | |
|
永続化された顔 ID
|
persistedFaceIds.persistedFaceId | string | |
|
名前
|
name | string | |
|
ユーザー データ
|
userData | string |
VerifyResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
同一
|
isIdentical | boolean |
2 つの顔が同じ人物に属している場合、または顔が人物に属している場合は True、それ以外の場合は false です。 |
|
信頼度
|
confidence | float |
数値は、2 つの顔が同じ人物に属しているかどうか、またはその人物に属しているかどうかの類似性の信頼度を示します。 |