One To One

"One to One" (OTO) compara dos imágenes faciales para determinar si pertenecen a la misma persona. Este proceso utiliza algoritmos avanzados de reconocimiento facial para proporcionar una validación de identidad instantánea y confiable, reduciendo significativamente el riesgo de fraude y asegurando la autenticidad de cada interacción.

Empezando

Para proceder, es indispensable generar una clave API con un tiempo de expiración definido.

Este proceso puede completarse fácilmente mediante el panel de administrado. Esto garantiza un acceso seguro y gestionado a los recursos necesarios durante el tiempo estipulado.

Para más detalles, consulta la documentación específica de cada método disponible a través de los siguientes enlaces:

Generación de clave API el panel de administrador API Keys Panel de Administrador

Verificar V1

POST basePath/api/v1/oto/verify

Este endpoint compara dos imágenes con rostros, examinando cuidadosamente las características faciales como la forma de los ojos, nariz y boca. Para ser consideradas, la cara debe ocupar al menos el 25% de la imagen y debe estar directamente frente a la cámara. En caso de haber múltiples rostros, se seleccionará el más grande. El resultado es una puntuación de similitud entre los rostros analizados así como detalles respecto a la distancia y códigos de error.

Descripción de la Solicitud

Petición

curl --request POST \
     --url https://api.sandbox.jaak.ai/api/v1/oto/verify \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
		 -d	"{
				 "image1": "imageBase64",
   			 "image2": "imageBase64"
				}"

Agrega localización

Si deseas agregar localización a la ejecución del evento agrega las cabeceras Longitude y Latitude con los valores numericos de la ubicación de la cual se esta ejecutando tu petición.

curl -X POST "https://api.sandbox.jaak.ai/api/v1/oto/verify" \
     -H 'accept: application/json' \
     -H 'content-type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -H 'Longitude: -70' \
     -H 'Latitude: 100' \
     -d '{...}'

Petición

{
    "image1": "imageBase64",
    "image2": "imageBase64",
}

Descripción de los parámetros

Parámetro	Descripción
image1	Cadena codificada en Base64 que representa la primera imagen.
image2	Cadena codificada en Base64 que representa la segunda imagen.
eventId	Identificador único del evento .

Respuesta

{
    "Verifyinfo": {
      "score": float
    },
    "eventId": "095a04cc-2ccd-4aca-9b46-5628c0511927",
 		"state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    }
}

Descripción de los parámetros

Parámetro	Descripción
Verifyinfo	Objeto que contiene información de verificación.
score	Puntuación de tipo flotante que indica el resultado de la verificación.
eventId	Identificador único del evento.
state	Describe el estado de la validación de una imagen facial en comparación de rostros, determinando si pertenecen a la misma persona y evaluando la calidad y el uso de accesorios.

Ejemplos de Solicitudes

{
 "image1": "imageBase64",
 "image2": "imageBase64"
}

# Respuesta
{
    "Verifyinfo": {
      "score": 98.9
    },
    "state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    }
    "eventId": "095a04cc-2ccd-4aca-9b46-5628c0511927"
}

Verificar V1.1

POST basePath/api/v1/oto/verify-codes

Descripción de la Solicitud

Petición

curl --request POST \
     --url https://api.sandbox.jaak.ai/api/v1/oto/verify-codes \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
		 -d	"{
 						"image1": "imageBase64",
 						"image2": "imageBase64"
				}"

Agrega localización

curl -X POST "https://api.sandbox.jaak.ai/api/v1/oto/verify-codes" \
     -H 'accept: application/json' \
     -H 'content-type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -H 'Longitude: -70' \
     -H 'Latitude: 100' \
     -d '{...}'

Descripción de los parámetros

Parámetro	Descripción
image1	Cadena codificada en Base64 que representa la primera imagen.
image2	Cadena codificada en Base64 que representa la segunda imagen.
eventId	Identificador único del evento .

Respuesta

{
    "Verifyinfo": {
      "score": 98.9,
      "code": [1, 2],
      "distance": 0.0
    },
   	"state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    },
    "eventId": "095a04cc-2ccd-4aca-9b46-5628c0511927"
}

Descripción de los parámetros

Parámetro	Descripción
Verifyinfo	Objeto que contiene información de verificación.
score	Puntuación de tipo flotante que indica el resultado de la verificación.
code	Lista de enteros que representan códigos de estado o resultado.
distance	Valor flotante que indica la distancia calculada, en este contexto, es 0.0.
eventId	Identificador único del evento.
state	Describe el estado de la validación de una imagen facial en comparación de rostros, determinando si pertenecen a la misma persona y evaluando la calidad y el uso de accesorios.

Ejemplos de Solicitudes

{
 "image1": "imageBase64",
 "image2": "imageBase64"
}

{
    "Verifyinfo": {
      "score": 98.9,
      "code": [1, 2],
      "distance": 0.0
    },
    "eventId": "095a04cc-2ccd-4aca-9b46-5628c0511927",
   	"state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    }
}

Verificar V2

POST basePath/api/v2/oto/verify

Descripción de la Solicitud

Petición

curl -X POST "https://api.sandbox.jaak.ai/api/v2/oto/verify" \
     -H 'accept: application/json' \
     -H 'content-type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -H 'Longitude: -70' \
     -H 'Latitude: 100' \
		 -d '{
        	"image1": "imageBase64",
        	"image2": "imageBase64",
				}'

Agrega localización

curl -X POST "https://api.sandbox.jaak.ai/api/v2/oto/verify \
     -H 'accept: application/json' \
     -H 'content-type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -H 'Longitude: -70' \
     -H 'Latitude: 100' \
     -d '{...}'

Descripción de los parámetros

Parámetro	Descripción
image1	Cadena codificada en Base64 que representa la primera imagen.
image2	Cadena codificada en Base64 que representa la segunda imagen.
eventId	Identificador único del evento .

Respuesta

{
    "eventId": "a733fe01-c28c-4adf-b699-1d1b8e226cf5",
    "requestId": "a733fe01-c28c-4adf-b699-1d1b8e226cf5",
    "score": 96.77462,
    "distance": 0.503788,
    "process_time": 1270,
    "metadata": {
        "image1": {
            "accessories": {
                "glass": false,
                "sunGlass": false,
                "hat": false,
                "mask": true
            },
            "image_quality": null
        },
        "image2": {
            "accessories": {
                "glass": true,
                "sunGlass": false,
                "hat": true,
                "mask": false
            },
            "image_quality": null
        }
    },
    "codes": null,
   	"state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    }
}

Descripción de los parámetros

Parámetro	Descripción
eventId	Identificador único del evento de la solicitud.
requestId	Identificador único de la solicitud.
score	Puntuación de comparación en porcentaje.
distance	Distancia de comparación. Rango de 0.0 a 1.0.
process_time	Tiempo de procesamiento de la solicitud en milisegundos.
metadata	Objeto que contiene datos sobre la calidad de la imagen y accesorios en las caras.
codes	Lista de enteros que representan códigos de error encontrados en las imágenes.
state	Describe el estado de la validación de una imagen facial en comparación de rostros, determinando si pertenecen a la misma persona y evaluando la calidad y el uso de accesorios.

Objeto metadata

Parámetro	Descripción
image1	Datos de la primera imagen.
accessories	Objeto que indica la presencia de accesorios como gafas, sombreros y mascarillas.
glass	Booleano que indica si hay gafas.
sunGlass	Booleano que indica si hay gafas de sol.
hat	Booleano que indica si hay sombrero.
mask	Booleano que indica si hay mascarilla.
image_quality	Calidad de la imagen (puede ser nulo).
image2	Datos de la segunda imagen, con la misma estructura que `image1`.

Ejemplos de Solicitudes

{
 "image1": "imageBase64",
 "image2": "imageBase64"
}

{
    "eventId": "a733fe01-c28c-4adf-b699-1d1b8e226cf5",
    "requestId": "a733fe01-c28c-4adf-b699-1d1b8e226cf5",
    "score": 96.77462,
    "distance": 0.503788,
    "process_time": 1270,
    "metadata": {
        "image1": {
            "accessories": {
                "glass": false,
                "sunGlass": false,
                "hat": false,
                "mask": true
            },
            "image_quality": null
        },
        "image2": {
            "accessories": {
                "glass": true,
                "sunGlass": false,
                "hat": true,
                "mask": false
            },
            "image_quality": null
        }
    },
    "codes": null,
   	"state": {
      "rejectedBadQuality": false,
      "rejectedAccessories": false,
      "isSamePerson": true,
      "message": ""
    }
}