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

Servicio:

Azure AI Services

Versión de la API:

v1.2-preview.1

Cree una nueva sesión de ejecución con comprobación. Proporcione la imagen de comprobación durante la creación de la sesión.
Una sesión es mejor para escenarios de dispositivos cliente en los que los desarrolladores desean autorizar a un dispositivo cliente a realizar solo una detección de ejecución sin conceder acceso completo a su recurso. Las sesiones creadas tienen un período de vida limitado y solo autorizan a los clientes a realizar la acción deseada antes de que expire el acceso.

Los permisos incluyen...

• • Capacidad de llamar a /detectLivenessWithVerify/singleModal para un máximo de 3 reintentos.
  • Duración del token de 10 minutos.

Nota

• • El acceso de cliente se puede revocar mediante la eliminación de la sesión mediante la operación Eliminar ejecución con comprobación de sesión.
  • Para recuperar un resultado, use Get Liveness With Verify Session.
  • Para auditar las solicitudes individuales realizadas por un cliente al recurso, use las entradas List Liveness With Verify Session Audit Entries (Enumerar vida con comprobar la auditoría de sesión).

Opción recomendada: VerifyImage se proporciona durante la creación de la sesión.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Parameters	formData	True	string	Parámetros para crear la sesión.
VerifyImage	formData	True	file	Flujo de imagen para comprobarlo. El campo de encabezado Content-Disposition para esta parte debe tener el nombre de archivo.
apiVersion	path	True	string	Versión de API
endpoint	path	True	string uri	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://{resource-name}.cognitiveservices.azure.com).

Respuestas

Nombre	Tipo	Description
200 OK	CreateLivenessWithVerifySessionResult	Una llamada correcta crea una sesión para un dispositivo cliente y proporciona un token de autorización para que lo use la aplicación cliente con un propósito y un tiempo limitados.
Other Status Codes	FaceErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Clave secreta de la suscripción de Azure AI Face.

Tipo: apiKey
En: header

AADToken

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://api.example.com/oauth2/authorize
Dirección URL del token: https://api.example.com/oauth2/token

Ámbitos

Nombre	Description
https://cognitiveservices.azure.com/.default

Ejemplos

Create LivenessWithVerify Session with VerifyImage

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
CreateLivenessWithVerifySessionResult	Respuesta de la sesión de ejecución con comprobación de la creación con la imagen de comprobación proporcionada.
FaceError	Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el vínculo siguiente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respuesta que contiene los detalles del error.
FaceRectangle	Rectángulo dentro del cual se puede encontrar una cara.
LivenessWithVerifyImage	Detalle de la cara para la comprobación.
QualityForRecognition	Indica la calidad de la imagen para el reconocimiento.

CreateLivenessWithVerifySessionResult

Respuesta de la sesión de ejecución con comprobación de la creación con la imagen de comprobación proporcionada.

Nombre	Tipo	Description
authToken	string	Token de portador para proporcionar autenticación para el SDK de Vision que se ejecuta en una aplicación cliente. Este token de portador tiene permisos limitados para realizar solo la acción necesaria y expira después del tiempo de TTL. También es auditable.
sessionId	string	Identificador de sesión único de la sesión creada. Expirará 48 horas después de que se creó o se puede eliminar antes mediante la operación delete de sesión correspondiente.
verifyImage	LivenessWithVerifyImage	Detalle de la cara para la comprobación.

FaceError

Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el vínculo siguiente: https://aka.ms/face-error-codes-and-messages.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
message	string	Representación legible del error.

FaceErrorResponse

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	FaceError	Objeto de error.

FaceRectangle

Rectángulo dentro del cual se puede encontrar una cara.

Nombre	Tipo	Description
height	integer	Alto del rectángulo, en píxeles.
left	integer	Distancia desde el borde izquierdo si la imagen al borde izquierdo del rectángulo, en píxeles.
top	integer	Distancia desde el borde superior si la imagen hasta el borde superior del rectángulo, en píxeles.
width	integer	Ancho del rectángulo, en píxeles.

LivenessWithVerifyImage

Detalle de la cara para la comprobación.

Nombre	Tipo	Description
faceRectangle	FaceRectangle	Región facial en la que se realizó la clasificación de la imagen de comparación.
qualityForRecognition	QualityForRecognition	Calidad de la imagen facial para el reconocimiento.

QualityForRecognition

Indica la calidad de la imagen para el reconocimiento.

Nombre	Tipo	Description
high	string	Alta calidad.
low	string	Baja calidad.
medium	string	Calidad media.