Liveness Session Operations - Create Liveness With Verify Session With Verify Image

サービス:

Azure AI Services

API バージョン:

v1.1-preview.1

検証を使用して新しいライブネス セッションをCreateします。 セッションの作成時に検証イメージを指定します。
セッションは、開発者がクライアント デバイスがリソースへのフル アクセスを許可せずにライブネス検出のみを実行することを承認する必要があるクライアント デバイスのシナリオに最適です。 作成されたセッションの有効期間は限られており、アクセスが期限切れになる前にクライアントが必要なアクションを実行することを承認するだけです。

アクセス許可には、次のものが含まれます...

• • 最大 3 回の再試行に対して /detectLivenessWithVerify/singleModal を呼び出す機能。
  • トークンの有効期間は 10 分です。

注意

• • クライアント アクセスを取り消すことができるのは、セッションの検証を使用したライブ状態の削除操作を使用してセッションを削除することです。
  • 結果を取得するには、Get Liveness With Verify Session を使用します。
  • クライアントがリソースに対して行った個々の要求を監査するには、List Liveness With Verify Session Audit Entries を使用します。

推奨されるオプション: セッションの作成時に VerifyImage が提供されます。

POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions

URI パラメーター

名前	/	必須	型	説明
Parameters	formData	True	string	セッションを作成するためのパラメーター。
VerifyImage	formData	True	file	検証用のイメージ ストリーム。 このパーツの Content-Disposition ヘッダー フィールドには filename が必要です。
apiVersion	path	True	string	API バージョン
endpoint	path	True	string uri	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名(例: https://{resource-name}.cognitiveservices.azure.com)。

応答

名前	型	説明
200 OK	CreateLivenessWithVerifySessionResult	呼び出しが成功すると、クライアント デバイスのセッションが作成され、限られた目的と時間のためにクライアント アプリケーションで使用される承認トークンが提供されます。
Other Status Codes	FaceErrorResponse	予期しないエラー応答。 ヘッダー x-ms-error-code: string

セキュリティ

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

スコープ

名前	説明
https://cognitiveservices.azure.com/.default

例

Create LivenessWithVerify Session with VerifyImage

要求のサンプル

HTTP

POST {endpoint}/face/v1.1-preview.1/detectLivenessWithVerify/singleModal/sessions

応答のサンプル

状態コード:

200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "verifyImage": {
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "qualityForRecognition": "high"
  }
}

定義

名前	説明
CreateLivenessWithVerifySessionResult	検証イメージを指定して作成を検証するライブネス セッションの応答。
FaceError	error オブジェクト。 Face Service によって返されるエラー コードとメッセージの包括的な詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages
FaceErrorResponse	エラーの詳細を含む応答。
FaceRectangle	顔が見つかる四角形。
LivenessWithVerifyImage	検証用の顔の詳細。
QualityForRecognition	認識する画像の品質を示します。

CreateLivenessWithVerifySessionResult

検証イメージを指定して作成を検証するライブネス セッションの応答。

名前	型	説明
authToken	string	クライアント アプリケーションで実行されている Vision SDK の認証を提供するベアラー トークン。 このベアラー トークンには、必要なアクションのみを実行するためのアクセス許可が制限されており、TTL 時間後に期限切れになります。 また、監査可能です。
sessionId	string	作成されたセッションの一意のセッション ID。 これは、作成されてから 48 時間後に期限切れになるか、対応するセッション削除操作を使用して、より早く削除される可能性があります。
verifyImage	LivenessWithVerifyImage	検証用の顔の詳細。

FaceError

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

名前	型	説明
code	string	サーバー定義のエラー コードのセットの 1 つ。
message	string	エラーの人間が判読できる表現。

FaceErrorResponse

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

名前	型	説明
error	FaceError	error オブジェクト。

FaceRectangle

顔が見つかる四角形。

名前	型	説明
height	integer	四角形の高さ (ピクセル単位)。
left	integer	画像から四角形の左端までの左端までの距離 (ピクセル単位)。
top	integer	画像から四角形の上端までの上端までの距離 (ピクセル単位)。
width	integer	四角形の幅 (ピクセル単位)。

LivenessWithVerifyImage

検証用の顔の詳細。

名前	型	説明
faceRectangle	FaceRectangle	比較画像の分類が行われた顔領域。
qualityForRecognition	QualityForRecognition	認識のための顔画像の品質。

QualityForRecognition

認識する画像の品質を示します。

名前	型	説明
high	string	高品質。
low	string	低品質。
medium	string	中程度の品質。