Saltar al contenido principal

​
1. Obtén tu clave de API

Inicia sesión en el Panel de DeepXL y crea una clave de API desde la sección Claves de API.

​
2. Detecta fraude documental

Sube un archivo al modelo de documentos para comprobar si ha sido manipulado: 
curl -X POST https://api.deepxl.ai/v1/detection \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=document" \
  -F "file=@bank_statement.pdf" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'
Recibirás una respuesta con una puntuación de probabilidad de fraude (0–100%), el nivel de gravedad (low, medium, high), la clasificación de calidad (verified, unverified, rejected) y un razonamiento detallado: 
{
  "result": {
    "detectionId": 42,
    "mediaType": "document",
    "fileType": "pdf",
    "fileName": "bank_statement.pdf",
    "fileSize": 245678,
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "document",
    "modelVersion": "1.1.0",
    "likelihood": 15.5,
    "fraudSeverity": "low",
    "classification": "verified",
    "reasoning": [
      "Document structure appears authentic",
      "No manipulation detected"
    ],
    "modelResults": {
      "technicalChecks": [
        { "type": "DOCUMENT_CLASSIFIER", "status": "PASS", "details": "Classified as bank statement", "likelihood": 0.0 },
        { "type": "SEMANTIC_QUALITY", "status": "PASS", "details": "Image quality is acceptable", "likelihood": 0.0 },
        { "type": "SEMANTIC_FRAUD", "status": "PASS", "details": "No tampering indicators found", "likelihood": 0.0 }
      ]
    },
    "files": [
      {
        "category": "original_file",
        "fileName": "fd_42_bank_statement.pdf",
        "url": "https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf"
      }
    ]
  }
}

​
3. Extrae datos de un documento

Usa el modelo de análisis para extraer datos estructurados de un documento de identidad: 
curl -X POST https://api.deepxl.ai/v1/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=light" \
  -F "file=@drivers_license.jpg"

{
  "result": {
    "parseId": 117,
    "mediaType": "image",
    "fileType": "jpeg",
    "fileName": "drivers_license.jpg",
    "fileSize": 231433,
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "light",
    "modelVersion": "1.2.0",
    "documentType": "idDocument",
    "parsedData": {
      "firstName": "JOHN",
      "lastName": "DOE",
      "dateOfBirth": "1990-05-15",
      "licenseNumber": "D1234567",
      "expirationDate": "2028-05-15",
      "address": "123 MAIN ST ANYTOWN, CA 90210"
    },
    "files": [
      {
        "category": "original_file",
        "fileName": "drivers_license.jpg",
        "url": "https://api.deepxl.ai/v1/files/parse_117_drivers_license.jpg"
      }
    ]
  }
}

​
4. Verifica la identidad

Usa el modelo de ID-selfie para comparar el documento de identidad de una persona con su selfie: 
curl -X POST https://api.deepxl.ai/v1/verification \
  -H "x-api-key: YOUR_API_KEY" \
  -F "idFile=@passport.jpg" \
  -F "selfieFile=@selfie.jpg"

{
  "result": {
    "verificationId": 457,
    "idFileName": "passport.jpg",
    "selfieFileName": "selfie.jpg",
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "verification",
    "modelVersion": "1.0.0",
    "verified": true,
    "modelResults": {
      "technicalChecks": [
        {
          "checkType": "face_detection",
          "likelihood": 99.85,
          "faceCount": { "id": 1, "selfie": 1 },
          "idFaces": [
            { "faceId": "face_1", "detectionConfidence": 0.9992 }
          ],
          "selfieFaces": [
            { "faceId": "face_1", "detectionConfidence": 0.9985 }
          ]
        }
      ]
    },
    "files": [
      {
        "category": "id",
        "fileName": "passport.jpg",
        "url": "https://api.deepxl.ai/v1/files/v_id_457_passport.jpg"
      },
      {
        "category": "face",
        "fileName": "selfie.jpg",
        "url": "https://api.deepxl.ai/v1/files/v_face_457_selfie.jpg"
      }
    ]
  }
}

​
¿Qué sigue?

Autenticación

Aprende sobre la autenticación con clave de API y token Bearer.

Guía de detección de fraude

Modelos de documentos y objetos, puntuaciones de probabilidad y filtrado.