Resumen de la API

La API v1 de ImageToTable.ai extrae datos estructurados de fotos, escaneos, PDFs, documentos de Word y archivos de texto plano de documentos reales — facturas, recibos, extractos bancarios, órdenes de compra y similares — y los devuelve como JSON. Esta página presenta los cuatro recursos sobre los que se basa todo lo demás en esta documentación.

Conceptos principales

Cuatro recursos cubren toda la superficie de la API. Cada endpoint en la sección de Referencia opera sobre uno de ellos.

• Documento — una página procesada individual. Se crea al subir una imagen, o una página PDF/Word/texto (una subida de varias páginas genera múltiples documentos, uno por página — consulte la referencia de Documentos). Un documento atraviesa un ciclo de vida de estado (queued → processing → succeeded / failed / canceled) explicado en detalle en la guía del Modelo de tarea asíncrona.
• Lote — un grupo con nombre de documentos que se suben y procesan juntos. Cada documento pertenece exactamente a un lote, identificado por su batch_name (una cadena que usted elige, o que la API genera automáticamente al subirlo). El procesamiento se inicia, el estado se consulta y los resultados se obtienen a nivel de lote.
• Plantilla — un conjunto guardado y reutilizable de campos que desea extraer cada vez (por ejemplo, una plantilla "Factura de proveedor" con invoice_number, vendor_name y total_amount). Las plantillas le evitan tener que redeclarar los mismos campos en cada llamada a process.
• Campo — un valor con nombre individual que desea extraer de un documento (un número de factura, una fecha, un importe de línea de detalle). Los campos residen en una Plantilla, o pueden declararse en línea, de forma puntual, en una sola llamada a process sin necesidad de crear una Plantilla.

Cómo encajan

Usted sube uno o más archivos a un lote, y cada archivo subido se convierte en un Documento. Luego inicia el procesamiento de ese lote, indicando a la API qué Campos desea recuperar — ya sea señalando una Plantilla guardada, o listando Campos directamente en el cuerpo de la solicitud. Si no especifica ninguno, la API infiere columnas razonables por sí sola. Una vez finalizado el procesamiento, obtiene los resultados del lote: cada Documento devuelve un arreglo line_items de objetos clave-valor por nombre de campo.

JSON es el formato principal

JSON es el formato de respuesta canónico y totalmente compatible para cada endpoint. Las exportaciones a Excel (.xlsx) y Word (.docx) existen como una descarga de conveniencia sobre los mismos datos (consulte Referencia de lotes) — no son un modelo de datos separado, y las integraciones de API deben construirse sobre la estructura JSON.

Autenticación y acceso

Cada solicitud v1 se autentica con una clave de API enviada como Authorization: Bearer <key> — sin respaldo de cookie de sesión, incluso si ha iniciado sesión desde el mismo navegador. La API v1 está disponible para planes de pago (Basic y superiores, incluidos equipos en Growth y superiores); las cuentas del plan gratuito reciben un error plan_required. Consulte Configuración del entorno para saber dónde encontrar su clave.

Próximos pasos

¿Listo para hacer su primera llamada? Inicio rápido le guía para obtener una clave, subir un documento, iniciar el procesamiento y obtener resultados — de principio a fin en unos cinco minutos. Para la lista completa de endpoints, consulte Referencia de API. Si está usando un asistente de codificación con IA para integrar, apúntelo directamente a la especificación OpenAPI 3.1 — es el mismo esquema detrás de cada página de Referencia, legible por máquina de principio a fin.