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
lightAnálisis rápido de documentos de identificación (licencias de conducir, pasaportes, identificaciones estatales)jpg, jpeg, png, webp, pdf
performanceAnálisis completo para todo tipo de documentos (facturas, recibos, formularios, contratos)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"}'

​
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",
    "likelihood": 100.0,
    "documentType": "usa_driver_license",
    "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" }
    ],
    "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 del 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
likelihoodfloatConfianza del análisis (ver abajo)
documentTypestringTipo de documento identificado (p. ej., usa_driver_license, invoice)
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

​
Probabilidad

  • 100.0 — El documento se reconoció y se analizó correctamente
  • -1.0 — No se reconoció el tipo de documento o no se pudo analizar

​
Tipo de documento

El campo documentType identifica el documento (p. ej., usa_driver_license, invoice, receipt, passport). Si el documento no se reconoce, esto será other.

​
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
Documentos generales (modelo de rendimiento): Los campos extraídos varían según el tipo de documento. Las facturas pueden incluir invoiceNumber, totalAmount, dueDate, etc.

​
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=@invoice.pdf" \
  -F 'tags={"customerId":"9999","documentId":"INV-2024-042"}'
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, likelihood, documentType, timestamp