VU Cloud Services

Un documento real no garantiza a su dueño real

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.

Selfie de una personaImagen "0" · selfie
Documento de identidad"1"
0
"biometric": {"0": {"1": 93}}93 ≥ 70 · misma persona

Seguridad respaldada por certificaciones y ensayos independientes

Conforme 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

El problema

Tener un documento válido no prueba quién lo está presentando

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.

Nuestra solución

Un puntaje por cada par de rostros. El umbral lo fijas tú.

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.

Características principales

Una llamada, las operaciones que elijas

Declaras, imagen por imagen, qué quieres analizar. Si no declaras ninguna operación, se ejecuta la comparación biométrica por defecto.

01

Comparación biométrica 1:1

Mide la similitud entre dos rostros con un puntaje de 0 a 100. Es la operación predeterminada.

0umbral 70
0100
"biometric": {"0": {"1": 93}}
02

Antispoofing en la misma llamada

El resultado de Antispoofing Facial llega anidado en la misma respuesta, sin necesidad de una segunda petición.

{
  "biometric": { … },
  "spoofing": { … }
}
03

Atributos faciales

Señales para determinar si la captura es apta.

  • nitidez
  • anteojos
  • ojos cerrados
  • mascarilla
04

Pose de la cabeza

Giro y cabeceo, en grados.

05

Posición de los iris

Coordenadas de ambos ojos.

Compara contra el documento o contra un rostro que ya guardaste

  • 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.

La integración

Dos endpoints y una regla de decisión.

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.

ElementoCómo funciona
GET /versionVerifica la conectividad. Se evalúa el código de estado, no el cuerpo de la respuesta
POST /inferenceEjecuta las operaciones solicitadas sobre las imágenes que envías
AutenticaciónCabecera Api-Key. Cada servicio tiene su propia clave, por ambiente
URL baseVU la entrega junto con la clave, según el ambiente
Entradainfo como referencia de negocio, images en base64 y operations, una lista por imagen
Salidaid, code, message y biometric (matriz de similitud de 0 a 100). Los demás campos dependen de las operaciones que solicites
PeticiónPOST /inference
// 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.
La regla de decisiónTu backend
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.

Requisitos de la imagen

La calidad de la captura decide cuánto vale el puntaje.

AspectoValor
Resolución recomendada360 × 360 o más*
RostroUno solo por imagen, de frente y con los ojos visibles
FormatoJPEG o PNG. Si es JPEG, calidad 90 o superior
Codificaciónbase64 sin prefijo data: y sin saltos de línea

*La resolución mínima aceptada es 160 × 160. Por debajo, la API devuelve error.

Manda 360 × 360 aunque el mínimo sea más bajoPor debajo de 360 px la API responde igual, con código 200, pero el veredicto de calidad baja a low. La compresión agresiva también degrada el puntaje. La calidad de la captura es una decisión de integración: fíjala al principio.
Cómo empiezas

Autogestionable, conecta esta API sin intermediarios

Con un plan pago, generas la clave desde el panel de VU y llamas al servicio desde tu backend.

  1. 02

    Confirmas el accesocon el método que te ofrezca el panel

  2. 03

    Abres Cloud Servicesen el menú lateral

  3. 04

    Eliges Face Analysisentre los servicios disponibles

  4. 05

    Generas la API keycon un plan pago, para el ambiente que vas a usar

  5. 06

    Copias la clave y llamas a GET /versionpara confirmar la conectividad

Genera tu API Key

Para generar tu API Key, necesitas un plan de pago de VU.

Preguntas frecuentes

No. Puedes consumirla de forma independiente, con su propia clave, sobre el flujo que elijas. Convive con el proveedor que ya tienes instalado.
Sí. Puedes solicitar el vector biométrico del rostro, almacenarlo y usarlo 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.
70 es el umbral de referencia para la metodología por defecto. Aun así, el servicio no toma la decisión por ti: tu política define a partir de qué puntaje confirmas la identidad. Si usas otra metodología, la escala del puntaje cambia y deberás calibrar tu propio umbral.
No por sí sola. La comparación biométrica mide cuánto se parecen dos rostros, pero no verifica si la selfie corresponde a una persona presente. Para eso existe Antispoofing Facial, que puedes solicitar en la misma llamada; su resultado llega anidado en la respuesta, sin necesidad de una segunda petición.
En la cabecera Api-Key de cada petición. Cada servicio tiene su propia clave para cada ambiente, y VU la proporciona junto con la URL base correspondiente.
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.

Ya tienes la selfie y el documento. Falta el puntaje.

Genera tu clave y compara un par que ya conoces.

Genera tu API Key

Para generar tu API Key, necesitas un plan de pago de VU.