Verificación de identidad

El modelo ID-Selfie verifica la identidad de una persona comparando su documento de identidad con una imagen o video de selfie. Realiza comparación facial y comprobaciones anti-spoofing.

Cómo funciona

Sube un documento de identidad (pasaporte, licencia de conducir, etc.)
Sube una imagen o video de selfie de la persona
La API compara los rostros y ejecuta comprobaciones anti-spoofing
Recibes un booleano verified y comprobaciones técnicas detalladas

Verificación de identidad

Envía ambos archivos mediante POST /v1/verification:

curl -X POST https://api.deepxl.ai/v1/verification \
  -H "x-api-key: YOUR_API_KEY" \
  -F "idFile=@passport.jpg" \
  -F "selfieFile=@selfie.jpg" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`idFile`	file	Sí	Imagen del documento de identidad (pasaporte, licencia de conducir, etc.)
`selfieFile`	file	Sí	Imagen o video tipo selfie de la persona
`tags`	string	No	Objeto JSON con pares clave-valor de metadatos
`country`	string	No	Sugerencia opcional de país. Valores admitidos: `us`, `mx`, `br`. Los valores faltantes, vacíos o no válidos usarán por defecto `us`.

Tipos de archivo compatibles

Documento de identidad: jpg, jpeg, png, webp Selfie: jpg, jpeg, png, webp, mp4 (video)

Estructura de la respuesta

{
  "result": {
    "verificationId": 5,
    "idFileType": "jpeg",
    "idFileName": "passport.jpg",
    "idFileSize": 174112,
    "selfieFileType": "jpeg",
    "selfieFileName": "selfie.jpg",
    "selfieFileSize": 250118,
    "timestamp": 1770984835,
    "timestampISO": "2026-02-13T13:13:55.213189",
    "model": "verification",
    "modelVersion": "1.0.0",
    "verified": true,
    "modelResults": {
      "technicalChecks": [
        {
          "checkType": "face_detection",
          "faceCount": { "id": 2, "selfie": 1 },
          "idFaces": [
            {
              "faceId": "face_1",
              "detectionConfidence": 0.9992,
              "landmarks": {
                "nose": { "x": 257.7, "y": 946.13 },
                "left_eye": { "x": 287.49, "y": 911.67 },
                "right_eye": { "x": 227.69, "y": 911.25 },
                "mouth_left": { "x": 283.88, "y": 971.12 },
                "mouth_right": { "x": 232.78, "y": 971.0 }
              },
              "boundingBox": { "x1": 195, "x2": 318, "y1": 838, "y2": 1013 }
            },
            {
              "faceId": "face_2",
              "detectionConfidence": 0.9865,
              "landmarks": {
                "nose": { "x": 696.46, "y": 885.83 },
                "left_eye": { "x": 701.44, "y": 879.83 },
                "right_eye": { "x": 690.77, "y": 880.29 },
                "mouth_left": { "x": 701.06, "y": 891.11 },
                "mouth_right": { "x": 692.61, "y": 891.52 }
              },
              "boundingBox": { "x1": 684, "x2": 707, "y1": 866, "y2": 898 }
            }
          ],
          "selfieFaces": [
            {
              "faceId": "face_1",
              "detectionConfidence": 0.9985,
              "landmarks": {
                "nose": { "x": 724.91, "y": 807.64 },
                "left_eye": { "x": 803.63, "y": 708.27 },
                "right_eye": { "x": 649.76, "y": 710.14 },
                "mouth_left": { "x": 793.35, "y": 871.12 },
                "mouth_right": { "x": 659.28, "y": 871.8 }
              },
              "boundingBox": { "x1": 569, "x2": 884, "y1": 523, "y2": 986 }
            }
          ]
        }
      ]
    },
    "tags": [
      { "name": "customerId", "value": "9999" },
      { "name": "customerName", "value": "Acme Corp" },
      { "name": "documentId", "value": "DOC-001" },
      { "name": "companyName", "value": "DeepXL" },
      { "name": "companyId", "value": "COMP-001" }
    ],
    "files": [
      {
        "category": "id",
        "fileName": "passport.jpg",
        "fileSize": 174112,
        "contentType": "image/jpeg",
        "timestamp": 1770984835,
        "timestampISO": "2026-02-13T13:13:55.213189",
        "url": "https://api.deepxl.ai/v1/files/v_id_5_passport.jpg"
      },
      {
        "category": "face",
        "fileName": "selfie.jpg",
        "fileSize": 250118,
        "contentType": "image/jpeg",
        "timestamp": 1770984835,
        "timestampISO": "2026-02-13T13:13:55.213189",
        "url": "https://api.deepxl.ai/v1/files/v_face_5_selfie.jpg"
      }
    ]
  }
}

Referencia de campos

Campo	Tipo	Descripción
`verificationId`	integer	Identificador único del registro de verificación
`idFileType`	string	Extensión del archivo del documento de identidad
`idFileName`	string	Nombre original del archivo del documento de identidad
`idFileSize`	integer	Tamaño del archivo del documento de identidad en bytes
`selfieFileType`	string	Extensión del archivo del selfie
`selfieFileName`	string	Nombre original del archivo del selfie
`selfieFileSize`	integer	Tamaño del archivo del selfie en bytes
`timestamp`	integer	Marca de tiempo Unix del análisis
`timestampISO`	string	Marca de tiempo ISO 8601 del análisis
`model`	string	Modelo utilizado (`verification`)
`modelVersion`	string	Versión del modelo utilizada para el análisis
`verified`	boolean	Si la identidad fue confirmada

Verificado

El campo verified es un booleano que indica si la identidad fue confirmada: el rostro en el selfie coincide con el rostro en el documento de identidad y las comprobaciones anti-spoofing se aprobaron.

Comprobaciones técnicas

El arreglo modelResults.technicalChecks contiene resultados de detección facial tanto para el documento de identidad como para el selfie. Detección facial (checkType: "face_detection"):

Campo	Tipo	Descripción
`faceCount`	object	Número de rostros detectados: recuento de `id` y recuento de `selfie`
`idFaces`	array	Rostros detectados en el documento de identidad
`selfieFaces`	array	Rostros detectados en el selfie

Cada objeto de rostro incluye:

Campo	Tipo	Descripción
`faceId`	string	Identificador del rostro (p. ej., `face_1`, `face_2`)
`detectionConfidence`	float	Confianza de detección facial (0.0–1.0)
`landmarks`	object	Coordenadas de puntos de referencia faciales (`nose`, `left_eye`, `right_eye`, `mouth_left`, `mouth_right`)
`boundingBox`	object	Coordenadas del cuadro delimitador del rostro (`x1`, `y1`, `x2`, `y2`)

Categorías de archivo

Categoría	Descripción
`id`	El documento de identidad cargado
`face`	La imagen o el video de selfie cargados

Etiquetas y filtrado

curl "https://api.deepxl.ai/v1/verification?tagFilter=customerId=9999" \
  -H "x-api-key: YOUR_API_KEY"

Exploración del historial

curl "https://api.deepxl.ai/v1/verification?limit=25&offset=0&sortBy=verificationId&direction=desc" \
  -H "x-api-key: YOUR_API_KEY"

Opciones de ordenación

verificationId, idFileName, idFileSize, idFileType, selfieFileName, selfieFileSize, selfieFileType, verified, timestamp

Primeros pasos

Guías

Verificación de identidad

Cómo funciona

Verificación de identidad

Parámetros

Tipos de archivo compatibles

Estructura de la respuesta

Referencia de campos

Verificado

Comprobaciones técnicas

Categorías de archivo

Etiquetas y filtrado

Exploración del historial

Opciones de ordenación

​Cómo funciona

​Verificación de identidad

​Parámetros

​Tipos de archivo compatibles

​Estructura de la respuesta

​Referencia de campos

​Verificado

​Comprobaciones técnicas

​Categorías de archivo

​Etiquetas y filtrado

​Exploración del historial

​Opciones de ordenación

Cómo funciona

Verificación de identidad

Parámetros

Tipos de archivo compatibles

Estructura de la respuesta

Referencia de campos

Verificado

Comprobaciones técnicas

Categorías de archivo

Etiquetas y filtrado

Exploración del historial

Opciones de ordenación