Face API

Microsoft Cognitive Services Face API では、写真の顔の検出、特定、分析、整理、タグ付けができます。

このコネクタは、次の製品および地域で利用可能です。

サービス クラス リージョン
Logic Apps 標準 すべての Logic Apps 地域
Power Automate Standard すべての Power Automate 地域
Power Apps Standard すべての Power Apps 地域
コネクタ メタデータ
公開元 Microsoft
Web サイト https://azure.microsoft.com/services/cognitive-services/face/

この統合を使用するには、Azure ポータルの Cognitive Service リソース が必要です。 エンドポイントとアプリケーションを認証するためのキーを取得します。 接続するには、アカウント キーとサイトの URL を入力し、接続の作成を選択します。 接続の運用コストについては、ここ で詳細を確認してください。

これで、この統合の使用を開始する準備が整いました。

Microsoft Entra ID との接続

Microsoft Entra ID との接続を作成するには、アカウントに Cognitive Services ユーザー ロールを追加してアクセスする必要があります。 この接続を使用するには、サポートされている操作に Cognitive Services リソースに関連付けられている一意のサブドメインを入力する必要があります。

Microsoft Entra ID 認証でサポートされていない操作

Microsoft Entra ID 認証を使用する場合、V2 アクションのみがサポートされています。 非推奨アクションは引き続き Access Key 認証で機能しますが、Microsoft Entra AAD 接続で使用すると失敗します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

API キー API キー すべての地域 共有可能
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

API キー

認証 ID: keyBasedAuth

適用できるもの: すべての領域

API キー

これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください

件名 タイプ 内容 必要
アカウント キー securestring Cognitive Services アカウント キー
サイトの URL 文字列 ルート サイト URL (例: https://westus.api.cognitive.microsoft.com)

既定 [非推奨]

適用できるもの: すべての領域

このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
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、name、ユーザー指定の userData とともに新しいユーザー グループを作成します。

ユーザー グループを取得する (V2)

その name や userData など、ユーザー グループの情報を取得します。

ユーザーの顔を取得する (V2)

persistedFaceId、personId、およびこの顔の所属 personGroupId で指定した、保持されている顔に関する情報を取得します。

ユーザーの顔を追加する (V2)

識別のために代表的な顔をユーザーに追加する。

ユーザーを作成する (V2)

指定したユーザー グループに新しいユーザーを作成します。

ユーザーを取得する

登録された永続的な顔、名前、userData などの個人の情報を取得します。

ユーザーを取得する (V2)

登録済みの保持されている顔、name、userData など、ユーザーの情報を取得します。

人の顔を追加する

識別のために人に代表的な顔を追加します。

人を作成する

指定した個人グループに新しい個人を作成します。

個人グループを取得する

その name や userData など、ユーザー グループの情報を取得します。

個人顔を取得する

persistedFaceId、personId、およびそれに属する personGroupId で指定された永続化された顔に関する情報を取得します。

顔からユーザーを検索する (V2)

2 つの顔が同じユーザーのものであるか、または 1 つの顔が 1 人のユーザーのものであるかを検証します。

顔から個人を検索する

2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が人物に属しているかどうかを確認します。

顔のリストを作成する

ユーザー指定の faceListId、name、およびオプションの userData を使用して空の顔リストを作成します。

顔のリストを取得する

顔リスト内の faceListId、name、userData、faces など、顔リストの情報を取得します。

顔を検出する

画像内の人間の顔を検出し、顔の位置を返します。オプションで、faceId、ランドマーク、属性を使用します。

顔を検出する (V2)

画像からユーザーの顔を検出し、必要に応じて、faceIds、landmarks、attributes とともに、顔の場所を返します。

顔リストに顔を追加

顔リストに顔を追加します。

顔リストに顔を追加する (V2)

顔リストに顔を追加します。

顔リストを作成する (V2)

ユーザー指定の faceListId、name、オプションの userData を使用して、空の顔リストを作成します。

顔リストを取得する (V2)

顔リスト内の faceListId、name、userData、faces など、顔リストの情報を取得します。

グループを作成する

指定された personGroupId、名前、およびユーザー提供の userData を使用して新しい個人グループを作成します。

パラメーター

名前 キー 必須 説明
個人グループ ID
personGroupId True string

新しい個人グループ ID (有効な文字には数字、小文字の英字、「-」および「_」が含まれます)

件名
name True string

個人グループ表示名。 最大長は 128 です。

ユーザー データ
userData string

個人グループに添付されたユーザー提供のデータ。 サイズの制限は 16KB です。

ユーザー グループを作成する (V2)

指定した personGroupId、name、ユーザー指定の userData とともに新しいユーザー グループを作成します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

ユーザー グループ ID
personGroupId True string

新しいユーザー グループ ID (有効な文字は、数字、小文字の英字、'-'、および '_' です)

件名
name True string

個人グループ表示名。 最大長は 128 です。

ユーザー データ
userData string

個人グループに添付されたユーザー提供のデータ。 サイズの制限は 16KB です。

ユーザー グループを取得する (V2)

その name や userData など、ユーザー グループの情報を取得します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

ユーザー グループ ID
personGroupId True string

ターゲット ユーザー グループ ID。

戻り値

本文​​
GetPersonGroupResponse

ユーザーの顔を取得する (V2)

persistedFaceId、personId、およびこの顔の所属 personGroupId で指定した、保持されている顔に関する情報を取得します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

ユーザー グループ ID
personGroupId True string

ターゲット ユーザーを含むユーザー グループの指定。

個人 ID
personId True string

顔が属する対象の個人を指定します。

永続的な Face ID
persistedFaceId True string

対象の persistedFaceId は、個人の永続的な顔です。

戻り値

本文​​
GetPersonFaceResponse

ユーザーの顔を追加する (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

任意の目的で追加するターゲットの顔に関するユーザー指定のデータ。 最大長は 1KB です。

戻り値

本文​​
AddPersonFaceResponse

ユーザーを作成する (V2)

指定したユーザー グループに新しいユーザーを作成します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

ユーザー グループ ID
personGroupId True string

ユーザーを作成するためにターゲット ユーザー グループの指定。

件名
name True string

対象の個人の表示名です。 最大長は 128 です。

ユーザー データ
userData string

個人に添付されたユーザー提供データのオプション フィールド。 サイズの制限は 16KB です。

戻り値

本文​​
CreatePersonResponse

ユーザーを取得する

登録された永続的な顔、名前、userData などの個人の情報を取得します。

パラメーター

名前 キー 必須 説明
個人グループ ID
personGroupId True string

ターゲット ユーザーを含むユーザー グループの指定。

個人 ID
personId True string

ターゲット ユーザーの指定。

戻り値

本文​​
GetPersonResponse

ユーザーを取得する (V2)

登録済みの保持されている顔、name、userData など、ユーザーの情報を取得します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

ユーザー グループ ID
personGroupId True string

ターゲット ユーザーを含むユーザー グループの指定。

個人 ID
personId True string

対象の個人を指定します。

戻り値

本文​​
GetPersonResponse

人の顔を追加する

識別のために人に代表的な顔を追加します。

パラメーター

名前 キー 必須 説明
個人グループ 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

任意の目的で追加するターゲットの顔に関するユーザー指定のデータ。 最大長は 1KB です。

戻り値

本文​​
AddPersonFaceResponse

人を作成する

指定した個人グループに新しい個人を作成します。

パラメーター

名前 キー 必須 説明
個人グループ ID
personGroupId True string

個人を作成する対象の個人グループを指定します。

件名
name True string

対象の個人の表示名です。 最大長は 128 です。

ユーザー データ
userData string

個人に添付されたユーザー提供データのオプション フィールド。 サイズの制限は 16KB です。

戻り値

本文​​
CreatePersonResponse

個人グループを取得する

その name や userData など、ユーザー グループの情報を取得します。

パラメーター

名前 キー 必須 説明
ユーザー グループ ID
personGroupId True string

ターゲット ユーザー グループ ID。

戻り値

本文​​
GetPersonGroupResponse

個人顔を取得する

persistedFaceId、personId、およびそれに属する personGroupId で指定された永続化された顔に関する情報を取得します。

パラメーター

名前 キー 必須 説明
個人グループ ID
personGroupId True string

対象の個人を含む個人グループを指定します。

個人 ID
personId True string

顔が属する対象の個人を指定します。

永続的な Face ID
persistedFaceId True string

ユーザーの保持されているターゲット顔の persistedFaceId。

戻り値

本文​​
GetPersonFaceResponse

顔からユーザーを検索する (V2)

2 つの顔が同じユーザーのものであるか、または 1 つの顔が 1 人のユーザーのものであるかを検証します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

顔 ID
faceId True string

検出された顔の一意の faceId。 検出呼び出しから 24 時間後に期限が切れます。

個人グループ ID
personGroupId True string

Face API で作成された個人グループ ID - 個人グループ アクションを作成します。

個人 ID
personId True string

Face API で作成された個人 ID - 個人アクションを作成します。

戻り値

本文​​
VerifyResponse

顔から個人を検索する

2 つの顔が同じ人物に属しているかどうか、または 1 つの顔が人物に属しているかどうかを確認します。

パラメーター

名前 キー 必須 説明
顔 ID
faceId True string

検出された顔の一意の faceId。 検出呼び出しから 24 時間後に期限が切れます。

個人グループ ID
personGroupId True string

Face API で作成された個人グループ ID - 個人グループ アクションを作成します。

個人 ID
personId True string

Face API で作成した "ユーザー ID" - ユーザー作成アクション。

戻り値

本文​​
VerifyResponse

顔のリストを作成する

ユーザー指定の faceListId、name、およびオプションの userData を使用して空の顔リストを作成します。

パラメーター

名前 キー 必須 説明
顔 リスト ID
faceListId True string

有効な文字は小文字または数字の文字、「-」または「_」で、最大長は 64

顔のリスト名
name True string

作成した顔リストの名前、最大長は 128 です。

ユーザー データ
userData string

顔リストのオプションのユーザー定義データ。 長さは 16KB を超えることはできません。

顔のリストを取得する

顔リスト内の faceListId、name、userData、faces など、顔リストの情報を取得します。

パラメーター

名前 キー 必須 説明
顔リスト ID
faceListId True string

ターゲット顔リストの faceListId。

戻り値

本文​​
GetFaceListResponse

顔を検出する

画像内の人間の顔を検出し、顔の位置を返します。オプションで、faceId、ランドマーク、属性を使用します。

パラメーター

名前 キー 必須 説明
画像 URL
url True string

画像は JPEG、PNG、GIF (最初のフレーム)、または BMP 形式とします

戻り値

顔を検出する (V2)

画像からユーザーの顔を検出し、必要に応じて、faceIds、landmarks、attributes とともに、顔の場所を返します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

画像 URL
url True string

画像は JPEG、PNG、GIF (最初のフレーム)、または BMP 形式とします

戻り値

顔リストに顔を追加

顔リストに顔を追加します。

パラメーター

名前 キー 必須 説明
画像 URL
url string

画像は JPEG、PNG、GIF (最初のフレーム)、または BMP である必要があります

ターゲットの顔
targetFace string

targetFace=left、top、width、height の形式で、人に追加するターゲットの顔を指定する顔の四角形

ユーザー データ
userData string

任意の目的で追加するターゲットの顔に関するユーザー指定のデータ。 最大長は 1KB です。

顔 リスト ID
faceListId True string

有効な文字は小文字、数字、'-'、または '_' です。最大長は 64 文字です。

戻り値

本文​​
AddPersonFaceResponse

顔リストに顔を追加する (V2)

顔リストに顔を追加します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

画像 URL
url string

画像は JPEG、PNG、GIF (最初のフレーム)、または BMP 形式とします

ターゲットの顔
targetFace string

targetFace=left、top、width、height の形式で、人に追加するターゲットの顔を指定する顔の四角形

ユーザー データ
userData string

任意の目的で追加するターゲットの顔に関するユーザー指定のデータ。 最大長は 1KB です。

顔 リスト ID
faceListId True string

有効な文字は小文字または数字の文字、「-」または「_」で、最大長は 64 です。

戻り値

本文​​
AddPersonFaceResponse

顔リストを作成する (V2)

ユーザー指定の faceListId、name、オプションの userData を使用して、空の顔リストを作成します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

顔リスト ID
faceListId True string

有効な文字は小文字、数字、'-'、または '_' です。最大長は 64 文字です

顔のリスト名
name True string

作成した顔リストの名前、最大長は 128 です。

ユーザー データ
userData string

顔リストのオプションのユーザー定義データ。 長さは 16KB を超えることはできません。

顔リストを取得する (V2)

顔リスト内の faceListId、name、userData、faces など、顔リストの情報を取得します。

パラメーター

名前 キー 必須 説明
リソースのサブドメインや地域
subdomain True string

Azure のサブドメインまたは地理的地域 (例: westus)

顔リスト ID
faceListId True string

ターゲット顔リストの faceListId。

戻り値

本文​​
GetFaceListResponse

定義

DetectResponse

名前 パス 説明
顔 ID
faceId string

検出された顔の一意の faceId。 検出呼び出しから 24 時間後に期限が切れます。

上詰め
faceRectangle.top integer

画像上の顔の位置の四角形領域のパラメータ。

← キー
faceRectangle.left integer

画像上の顔の位置の四角形領域のパラメータ。

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

名前 パス 説明
永続的な Face ID
persistedFaceId string

GetPersonGroupResponse

名前 パス 説明
個人グループ ID
personGroupId string
件名
name string
userData
userData string

GetFaceListResponse

名前 パス 説明
永続的な顔
persistedFaces array of object
永続的な Face ID
persistedFaces.persistedFaceId string

顔の ID。

ユーザー データ
persistedFaces.userData string

各顔に添付されたユーザー提供のデータ。

顔 リスト ID
faceListId string

対象の顔リストの faceListId。

件名
name string

顔の一覧の表示名。

ユーザー データ
userData string

顔の一覧に添付されたユーザー提供のデータ。

GetPersonFaceResponse

名前 パス 説明
永続的な Face ID
persistedFaceId string
userData
userData string

CreatePersonResponse

名前 パス 説明
個人 ID
personId string

GetPersonResponse

名前 パス 説明
個人 ID
personId string
永続的な顔 ID
persistedFaceIds array of object
永続的な Face ID
persistedFaceIds.persistedFaceId string
件名
name string
ユーザー データ
userData string

VerifyResponse

名前 パス 説明
同一です
isIdentical boolean

2 つの顔が同じ人物に属している場合、または顔がその人物に属している場合は true、それ以外の場合は false。

信頼度
confidence float

数字は、2 つの顔が同じ人物に属しているかどうか、または顔がその人物に属しているかどうかの類似性の信頼度を示します。