Saltar al contenido principal
El modelo de análisis extrae y analiza datos estructurados de identificaciones y documentos: nombres, fechas, direcciones, importes y más.

​
Modelos disponibles

ModeloCaso de usoTipos de archivo compatibles
lightModelo de análisis ligero. La extracción de datos está orientada a licencias de conducir, documento de identidad estatal, permiso de residencia, tarjeta del Seguro Social, identificación militarjpg, jpeg, png, webp, pdf
performanceModelo de análisis de alto rendimiento. La extracción de datos está orientada a estados de cuenta bancarios, talones de pago de EE. UU. y documentos de identidad emitidos por el gobierno (por ejemplo, licencias de conducir)jpg, jpeg, png, webp, pdf
Recupera la lista completa de modelos mediante programación: 
curl https://api.deepxl.ai/v1/parsing-models \
  -H "x-api-key: YOUR_API_KEY"

​
Analizar un documento

Envía un archivo para analizar mediante POST /v1/parse: 
curl -X POST https://api.deepxl.ai/v1/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=light" \
  -F "file=@drivers_license.jpg" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'

​
Parámetros

ParámetroTipoObligatorioDescripción
modelstringSílight o performance
filefileSíEl documento que se va a analizar (máx. 50MB)
tagsstringNoObjeto JSON con pares clave-valor de metadatos

​
Estructura de la respuesta

{
  "result": {
    "parseId": 123,
    "mediaType": "image",
    "fileType": "jpeg",
    "fileName": "drivers_license.jpg",
    "fileSize": 231433,
    "timestamp": 1770984134,
    "timestampISO": "2026-02-13T13:02:14.833162",
    "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"
    },
    "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": "original_file",
        "fileName": "drivers_license.jpg",
        "fileSize": 231433,
        "contentType": "image/jpeg",
        "timestamp": 1770984134,
        "timestampISO": "2026-02-13T13:02:14.833162",
        "url": "https://api.deepxl.ai/v1/files/parse_123_drivers_license.jpg"
      }
    ]
  }
}

​
Referencia de campos

CampoTipoDescripción
parseIdintegerIdentificador único del registro de análisis
mediaTypestringCategoría de tipo de medio (image o document)
fileTypestringExtensión de archivo (jpeg, png, pdf, webp)
fileNamestringNombre original del archivo subido
fileSizeintegerTamaño del archivo en bytes
timestampintegerMarca de tiempo Unix del análisis
timestampISOstringMarca de tiempo ISO 8601 del análisis
modelstringModelo usado (light o performance)
modelVersionstringVersión del modelo usada para el análisis
documentTypestringTipo de documento identificado (p. ej., idDocument, bankStatement.us, payStub.us)
parsedDataobjectPares clave-valor extraídos (los campos varían según el tipo de documento)
tagsobject[]Etiquetas de metadatos adjuntas a este análisis
filesobject[]Archivos asociados (carga original)

​
Comprender los resultados

​
Tipo de documento

El campo documentType identifica el tipo de documento analizado (por ejemplo, idDocument, bankStatement.us o payStub.us).

​
Datos analizados

El objeto parsedData contiene los pares clave-valor extraídos. Los campos dependen del tipo de documento. Documentos de identificación (modelo ligero):
CampoDescripción
firstNameNombre
lastNameApellido
dateOfBirthFecha de nacimiento (AAAA-MM-DD)
licenseNumberNúmero de licencia o documento
expirationDateFecha de vencimiento del documento (AAAA-MM-DD)
addressDirección completa
Tipos de documento del modelo performance: Los campos extraídos varían según el tipo de documento. El conjunto actual es idDocument, bankStatement.us y payStub.us.

​
Etiquetas y filtrado

Adjunta metadatos para organizar tus resultados de análisis: 
curl -X POST https://api.deepxl.ai/v1/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=performance" \
  -F "file=@bank_statement.pdf" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-2024-042","companyName":"DeepXL","companyId":"COMP-001"}'
Filtra tu historial de análisis: 
curl "https://api.deepxl.ai/v1/parse?tagFilter=customerId=9999" \
  -H "x-api-key: YOUR_API_KEY"

​
Explorar el historial

Recupera resultados de análisis paginados: 
curl "https://api.deepxl.ai/v1/parse?limit=25&offset=0&sortBy=parseId&direction=desc" \
  -H "x-api-key: YOUR_API_KEY"

​
Opciones de ordenación

parseId, mediaType, fileType, fileName, fileSize, confidence, documentType, timestamp