Comparación biométrica 1:1
Mide la similitud entre dos rostros con un puntaje de 0 a 100. Es la operación predeterminada.
"biometric": {"0": {"1": 93}}Face Analysis compara la selfie de una persona contra la foto de su documento y te devuelve un puntaje de similitud de 0 a 100. Una llamada a la API y sabes si es la misma persona.
Para generar tu API Key, necesitas un plan de pago de VU.
Imagen "0" · selfie
"biometric": {"0": {"1": 93}}93 ≥ 70 · misma personaConforme a iBeta PAD Nivel 3
ISO/IEC 30107-3 · Prueba de vida
ISO/IEC 27001:2022
Gestión de seguridad de la información
ISO/IEC 27017:2015
Seguridad en servicios de nube
Un documento robado, prestado o adquirido de forma irregular supera los controles documentales porque es auténtico: los datos coinciden y el formato es correcto. La pregunta que queda sin resolver es si el rostro de la selfie corresponde a su titular. Cuando esa comparación depende de una persona que revisa dos fotografías, el proceso no escala ni deja un criterio auditable.
El servicio compara los rostros enviados y devuelve su nivel de similitud en una escala de 0 a 100. La decisión no es automática: la política interna que determines evalúa el puntaje con el que se confirma la identidad. El servicio tampoco verifica si la selfie corresponde a una persona presente; esa validación la realiza Antispoofing Facial, que puede solicitarse en la misma llamada.
Caso 01
Ya cuentas con otro proveedor
No es necesario migrar toda tu operación para incorporar la comparación biométrica. Puedes consumir únicamente esta API, en paralelo con tu proveedor actual.
Caso 02
Necesitas verificar a clientes recurrentes
Durante el registro, se almacena el vector biométrico del rostro de tu cliente. En cada nueva interacción, se compara su selfie con ese vector, sin necesidad de solicitarle nuevamente el documento.
Caso 03
Estás construyendo tu propio producto
Necesitas el componente de comparación facial, no una plataforma completa. Lo integras a tu solución y mantienes el control sobre el resto del proceso.
Declaras, imagen por imagen, qué quieres analizar. Si no declaras ninguna operación, se ejecuta la comparación biométrica por defecto.
Mide la similitud entre dos rostros con un puntaje de 0 a 100. Es la operación predeterminada.
"biometric": {"0": {"1": 93}}El resultado de Antispoofing Facial llega anidado en la misma respuesta, sin necesidad de una segunda petición.
{ "biometric": { … }, "spoofing": { … } }
Señales para determinar si la captura es apta.
Giro y cabeceo, en grados.
Coordenadas de ambos ojos.
Selfie contra documento
Envías ambas imágenes y recibes el puntaje de similitud entre ellas. La foto del documento puede obtenerse de ID Analysis, que la entrega ya recortada.
Selfie contra un vector guardado
Solicitas el vector biométrico del rostro, lo almacenas y lo usas en comparaciones futuras, sin necesidad de conservar la foto. Registra también la metodología con la que lo generaste, ya que la escala del puntaje varía según la metodología.
Calidad de la captura
Si solicitas atributos y pose en la misma llamada, la respuesta incluye un veredicto de calidad: high, medium o low. Si el resultado es low, solicita una nueva captura antes de confiar en el puntaje.
Integración
No reemplaza a Identity Link cuando necesitas una verificación completa. Puedes usarlo de forma independiente o combinarlo con otros servicios de VU Cloud Services.
Sin SDK ni dependencias. Llama a la API desde tu backend: La clave nunca queda expuesta en una app móvil ni en el navegador.
| Elemento | Cómo funciona |
|---|---|
| GET /version | Verifica la conectividad. Se evalúa el código de estado, no el cuerpo de la respuesta |
| POST /inference | Ejecuta las operaciones solicitadas sobre las imágenes que envías |
| Autenticación | Cabecera Api-Key. Cada servicio tiene su propia clave, por ambiente |
| URL base | VU la entrega junto con la clave, según el ambiente |
| Entrada | info como referencia de negocio, images en base64 y operations, una lista por imagen |
| Salida | id, code, message y biometric (matriz de similitud de 0 a 100). Los demás campos dependen de las operaciones que solicites |
// Cabecera: Api-Key: <tu clave del servicio>
{
"info": "onboarding-12345",
"images": ["<selfie en base64>", "<rostro del documento>"],
"operations": [["biometric"], ["biometric"]]
}"biometric": {"0": {"1": 93}}93 es mayor o igual a 70. Es la misma persona: confirmas."biometric": {"0": {"1": 19}}Por debajo del umbral. No confirmas.if (status === 200 && body.biometric?.["0"]?.["1"] >= 70) {
mismaPersona();
} else {
noConfirmada();
}No confirmes por descarte
No hay un código de error que indique "no es la misma persona": cuando los rostros no coinciden, la respuesta llega con código 200 y un puntaje bajo. Si tu lógica aprueba todo lo que no sea un rechazo explícito, cualquier respuesta inesperada terminará convertida en una aprobación.
El umbral de 70 aplica a la metodología por defecto. Si eliges otra, la escala del puntaje cambia y deberás calibrar tu propio umbral.
| Aspecto | Valor |
|---|---|
| Resolución recomendada | 360 × 360 o más* |
| Rostro | Uno solo por imagen, de frente y con los ojos visibles |
| Formato | JPEG o PNG. Si es JPEG, calidad 90 o superior |
| Codificación | base64 sin prefijo data: y sin saltos de línea |
*La resolución mínima aceptada es 160 × 160. Por debajo, la API devuelve error.
Con un plan pago, generas la clave desde el panel de VU y llamas al servicio desde tu backend.
Confirmas el accesocon el método que te ofrezca el panel
Abres Cloud Servicesen el menú lateral
Eliges Face Analysisentre los servicios disponibles
Generas la API keycon un plan pago, para el ambiente que vas a usar
Copias la clave y llamas a GET /versionpara confirmar la conectividad
Para generar tu API Key, necesitas un plan de pago de VU.
Genera tu clave y compara un par que ya conoces.
Para generar tu API Key, necesitas un plan de pago de VU.