Saltar al contenido principal
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

  1. Sube un documento de identidad (pasaporte, licencia de conducir, etc.)
  2. Sube una imagen o video de selfie de la persona
  3. La API compara los rostros y ejecuta comprobaciones anti-spoofing
  4. 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"}'

​
Parámetros

ParámetroTipoObligatorioDescripción
idFilefileSíImagen del documento de identidad (pasaporte, licencia de conducir, etc.)
selfieFilefileSíImagen o video de selfie de la persona
tagsstringNoObjeto JSON con pares clave-valor de metadatos

​
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" }
    ],
    "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

CampoTipoDescripción
verificationIdintegerIdentificador único del registro de verificación
idFileTypestringExtensión del archivo del documento de identidad
idFileNamestringNombre original del archivo del documento de identidad
idFileSizeintegerTamaño del archivo del documento de identidad en bytes
selfieFileTypestringExtensión del archivo del selfie
selfieFileNamestringNombre original del archivo del selfie
selfieFileSizeintegerTamaño del archivo del selfie en bytes
timestampintegerMarca de tiempo Unix del análisis
timestampISOstringMarca de tiempo ISO 8601 del análisis
modelstringModelo utilizado (verification)
modelVersionstringVersión del modelo utilizada para el análisis
verifiedbooleanSi 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"):
CampoTipoDescripción
faceCountobjectNúmero de rostros detectados: recuento de id y recuento de selfie
idFacesarrayRostros detectados en el documento de identidad
selfieFacesarrayRostros detectados en el selfie
Cada objeto de rostro incluye:
CampoTipoDescripción
faceIdstringIdentificador del rostro (p. ej., face_1, face_2)
detectionConfidencefloatConfianza de detección facial (0.0–1.0)
landmarksobjectCoordenadas de puntos de referencia faciales (nose, left_eye, right_eye, mouth_left, mouth_right)
boundingBoxobjectCoordenadas del cuadro delimitador del rostro (x1, y1, x2, y2)

​
Categorías de archivo

CategoríaDescripción
idEl documento de identidad cargado
faceLa 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