你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Liveness Session Operations - Get Liveness With Verify Session Result

服务:: Azure AI Services

API 版本:: v1.2

获取 detectLivenessWithVerify/singleModal 调用的会话结果。

GET {endpoint}/face/{apiVersion}/detectLivenessWithVerify-sessions/{sessionId}

URI 参数

名称	在	必需	类型	说明
apiVersion	path	True	string	API 版本
endpoint	path	True	string (uri)	支持的认知服务终结点（协议和主机名，例如：https://{resource-name}.cognitiveservices.azure.com）。
sessionId	path	True	string	要引用此会话的唯一 ID。

响应

名称	类型	说明
200 OK	LivenessWithVerifySession	请求已成功。
Other Status Codes	FaceErrorResponse	意外的错误响应。标头 x-ms-error-code: string

名称

类型

说明

200 OK

LivenessWithVerifySession

请求已成功。

Other Status Codes

FaceErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 人脸订阅的密钥。

类型: apiKey
在: header

AADToken

Azure Active Directory OAuth2 流

类型: oauth2
流向: accessCode
授权 URL: https://api.example.com/oauth2/authorize
令牌 URL: https://api.example.com/oauth2/token

作用域

名称	说明
https://cognitiveservices.azure.com/.default

示例

Get LivenessWithVerify Session Result

示例请求

HTTP

GET {endpoint}/face/v1.2/detectLivenessWithVerify-sessions/b12e033e-bda7-4b83-a211-e721c661f30e

示例响应

状态代码:: 200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "status": "NotStarted",
  "modelVersion": "2024-11-15",
  "results": {
    "attempts": [
      {
        "attemptId": 2,
        "attemptStatus": "Succeeded",
        "result": {
          "livenessDecision": "realface",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          },
          "verifyResult": {
            "matchConfidence": 0.08871888,
            "isIdentical": false
          },
          "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
          "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I",
          "verifyImageHash": "43B7D8E8769533C3290DBD37A84D821B2C28CB4381DF9C6784DBC4AAF7E45018"
        }
      },
      {
        "attemptId": 1,
        "attemptStatus": "Failed",
        "error": {
          "code": "FaceWithMaskDetected",
          "message": "Mask detected on face image.",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          }
        }
      }
    ],
    "verifyReferences": [
      {
        "referenceType": "image",
        "faceRectangle": {
          "top": 316,
          "left": 131,
          "width": 498,
          "height": 677
        },
        "qualityForRecognition": "high"
      }
    ]
  }
}

定义

名称	说明
FaceError	错误对象。有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。
FaceErrorResponse	包含错误详细信息的响应。
FaceRectangle	在其中可以找到人脸的矩形。
ImageType	图像的类型。
LivenessColorDecisionTarget	用于实时分类的颜色图像中的目标。
LivenessDecision	生存度分类的结果。
LivenessDecisionTargets	用于生存度分类的目标。
LivenessError	生存度分类的错误。
LivenessModel	用于实时分类的模型版本。
LivenessWithVerifyOutputs	人脸验证输出。
LivenessWithVerifyReference	用于验证的人脸的详细信息。
LivenessWithVerifyResult	通过验证调用的实时性结果。
LivenessWithVerifySession	通过验证检测实时的会话结果。
LivenessWithVerifySessionAttempt	验证会话尝试的实时性。
LivenessWithVerifySessionResults	验证会话的实时性结果。
OperationState	会话的当前状态。
QualityForRecognition	指示用于识别的图像质量。

FaceError

Object

错误对象。有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
message	string	错误的人工可读表示形式。

FaceErrorResponse

Object

包含错误详细信息的响应。

名称	类型	说明
error	FaceError	错误对象。

FaceRectangle

Object

在其中可以找到人脸的矩形。

名称	类型	说明
height	integer (int32)	矩形的高度（以像素为单位）。
left	integer (int32)	如果图像到矩形左边缘（以像素为单位）的距离。
top	integer (int32)	图像到矩形上边缘（以像素为单位）的距离。
width	integer (int32)	矩形的宽度（以像素为单位）。

ImageType

枚举

图像的类型。

值	说明
Color	彩色图像。
Infrared	红外图像。
Depth	深度图像。

LivenessColorDecisionTarget

Object

用于实时分类的颜色图像中的目标。

名称	类型	说明
faceRectangle	FaceRectangle	进行活泼分类的人脸区域。

LivenessDecision

枚举

生存度分类的结果。

值	说明
uncertain	该算法无法将目标人脸分类为真实或欺骗。
realface	该算法已将目标人脸分类为真实。
spoofface	该算法已将目标人脸分类为欺骗。

LivenessDecisionTargets

Object

用于生存度分类的目标。

名称	类型	说明
color	LivenessColorDecisionTarget	用于实时分类的颜色图像中的目标。

LivenessError

Object

生存度分类的错误。

名称	类型	说明
code	string	错误代码。
message	string	错误消息。
targets	LivenessDecisionTargets	用于生存度分类的目标。

LivenessModel

枚举

用于实时分类的模型版本。

值	说明
2024-11-15

LivenessWithVerifyOutputs

Object

人脸验证输出。

名称	类型	说明
isIdentical	boolean	目标实时人脸和比较图像人脸是否匹配。
matchConfidence	number (float) minimum: 0 maximum: 1	目标人脸活泼面和比较图像人脸验证置信度。

LivenessWithVerifyReference

Object

用于验证的人脸的详细信息。

名称	类型	说明
faceRectangle	FaceRectangle	进行了比较图像分类的人脸区域。
qualityForRecognition	QualityForRecognition	用于识别的人脸图像的质量。
referenceType	ImageType	图像类型，其中包含在其中进行动态分类的人脸矩形。

LivenessWithVerifyResult

Object

通过验证调用的实时性结果。

名称	类型	说明
digest	string	此请求的服务器计算摘要。如果客户端报告的摘要与服务器计算摘要不同，则客户端和服务之间的消息完整性已泄露，因此不应信任结果。有关详细信息，请参阅有关如何利用此值来保护端到端解决方案的指南。
livenessDecision	LivenessDecision	目标人脸的活度分类。
sessionImageId	string	会话请求的图像 ID。
targets	LivenessDecisionTargets	用于生存度分类的目标。
verifyImageHash	string	请求中验证映像的 sha256 哈希。
verifyResult	LivenessWithVerifyOutputs	人脸验证输出。仅当请求为验证时可用。

LivenessWithVerifySession

Object

通过验证检测实时的会话结果。

名称	类型	说明
authToken	string	持有者令牌，用于为客户端应用程序上运行的视觉 SDK 提供身份验证。此持有者令牌具有有限的权限，只能执行所需的操作，并在 TTL 时间后过期。它也是可审核的。
modelVersion	LivenessModel	用于实时分类的模型版本。这是一个可选参数，如果未指定此参数，则将选择最新的受支持的模型版本
results	LivenessWithVerifySessionResults	验证会话的实时性结果。
sessionId	string	要引用此会话的唯一 ID。
status	OperationState	会话的当前状态。

LivenessWithVerifySessionAttempt

Object

验证会话尝试的实时性。

名称	类型	说明
attemptId	integer (int32)	尝试 ID，从 1 开始。
attemptStatus	OperationState	尝试的状态。
error	LivenessError	验证调用的实时性错误，如果结果为 null。
result	LivenessWithVerifyResult	如果出现错误，则验证调用的生存度结果将为 null。

LivenessWithVerifySessionResults

Object

验证会话的实时性结果。

名称	类型	说明
attempts	LivenessWithVerifySessionAttempt[]	尝试使用会话进行验证调用的基础生存期数据。
verifyReferences	LivenessWithVerifyReference[]	用于人脸验证的参考。

OperationState

枚举

会话的当前状态。

值	说明
NotStarted	操作尚未启动。
Running	操作正在进行中。
Succeeded	操作已成功完成。
Failed	操作失败。
Canceled	该操作已被用户取消。

QualityForRecognition

枚举

指示用于识别的图像质量。

值	说明
low	质量低。
medium	中等质量。
high	高质量。