Claix es una API B2B de infraestructura de contexto para agentes de IA que convierte PDFs, Excel/CSV, documentos Word/texto e imágenes en JSON estrictamente tipado según un schema definido por el desarrollador — también integrable en sistemas backend y automatización. Sitio oficial: https://www.claix.dev

¿Qué formatos admite la API de Claix?

Claix admite Excel (.xlsx) y CSV, JSON para exportar a Excel, PDF (texto o escaneado), documentos .docx/.txt/.md/.rtf, imágenes .jpeg/.jpg/.png/.webp/.heic/.heif, y texto/HTML/XML vía campo content. Cada formato usa un endpoint y un tipo de schema específico.

¿Cómo convierto un PDF a JSON con Claix?

Crea un schema de tipo pdf-json, obtén una API key y envía un POST multipart a https://claix.dev/api/pdf-json con los campos file y schema_id y la cabecera x-api-key. Documentación: https://www.claix.dev/documentation/pdf-to-json

¿Cuál es el modelo de precios de Claix?

Pay-as-you-go. Las 15 primeras llamadas exitosas (HTTP 200) son gratis. Excel↔JSON cobra por volumen de variables (€0,25–€1,00). PDF→JSON €0,35, Doc→JSON €0,20, Img→JSON €0,10 y Txt/HTML/XML→JSON €0,10 por envío exitoso. Ventana de contexto temporal: 0,05 € por llamada (hasta 5 consultas, 0,01 € cada una). Los errores 4xx/5xx no se facturan.

¿Claix tiene un widget embebible?

Sí. Claix ofrece un widget iframe gratuito e ilimitado en uso de UI (https://www.claix.dev/widget/{id}), personalizable y listo para producción. El JSON se entrega al webhook HTTPS del dueño; la API key nunca se expone en el navegador.

¿Dónde está la especificación OpenAPI?

La especificación OpenAPI 3 está en https://www.claix.dev/openapi.yaml. El resumen para IAs está en https://www.claix.dev/llms.txt y la base de conocimiento completa en https://www.claix.dev/llms-full.txt.

¿Claix es compatible con n8n y Make?

Sí. Puedes usar HTTP multipart genérico o el nodo comunitario n8n-nodes-claix. Guía: https://www.claix.dev/blog/integrar-claix-en-n8n

¿Claix cumple el RGPD?

Claix ofrece procesamiento orientado a la UE, DPA público en https://www.claix.dev/dpa, sin retención de archivos para entrenar modelos y sin entrenamiento sobre documentos del cliente.

Ventana de Contexto Temporal · Consulta

Consulta de contenido bruto de un documento procesado

Endpoint

GEThttps://claix.dev/window-context/{document_id}

Este endpoint devuelve el contenido bruto y los metadatos de un documento concreto que ya fue procesado previamente por alguno de los endpoints de extracción de Claix (pdf-json, doc-json, img-json, etc.). A diferencia de esos endpoints, que transforman un archivo y devuelven datos estructurados según un schema, este endpoint es de solo lectura: no procesa nada, simplemente recupera lo que ya se guardó de un procesamiento anterior — el texto/markdown bruto del documento, cuándo se procesó, con qué nombre de archivo, y con qué schema.

Está pensado para integraciones server-to-server (backends, scripts, n8n/Zapier/Make). No debe llamarse desde el navegador de un usuario final porque requiere una API key secreta.

Esta llamada es gratuita: no se factura ni consume tu cupo de extracciones, exactamente igual que GET /api/schemas.

1. Autenticación

Toda petición debe incluir tu API key. Es una credencial de servidor personal, distinta de cualquier token de sesión de usuario.

Opción A — Header dedicado (recomendado):

x-api-key: <TU_API_KEY>

Opción B — Header estándar Authorization:

Authorization: Bearer <TU_API_KEY>

Con uno de los dos es suficiente. Si envías ambos, x-api-key tiene prioridad.

Antes de devolver datos, el sistema valida que:

La API key exista y esté activa.
La cuenta asociada esté activa (no suspendida).

Si falla, se rechaza con 401.

2. Formato de la petición

Método: GET · Body: ninguno · Query params: ninguno

El document_id forma parte de la ruta, no va en el body ni en query params:

GET https://claix.dev/window-context/{document_id}

Sustituye {document_id} por el UUID real del documento.

Requisitos del document_id:

Debe tener formato UUID válido; si no, responde 400.
Debe corresponder a un documento que exista y pertenezca a la cuenta de tu API key.
El documento no debe haber expirado (expires_at en el pasado).

3. Cómo construir la llamada

Ten a mano tu API key.
Ten a mano el document_id (normalmente lo obtienes en la respuesta de una extracción con window_context activo).
Construye un GET a https://claix.dev/window-context/{document_id} sustituyendo {document_id} por el UUID real.
Añade el header de autenticación.
No añadas body ni query params.
Comprueba el código HTTP: solo 200 indica éxito.

4. Ejemplos de llamada

Consulta el panel de la derecha para ver ejemplos en cURL, JavaScript, Node.js, Python, PHP y n8n.

5. Formato de la respuesta exitosa

200 OK · Content-Type: application/json

{
  "success": true,
  "document_id": "d4a1e9d2-8b1c-4f3e-9a02-8b1e9f3c7a4b",
  "file_name": "dni_cliente_ana.jpg",
  "schema_id": "b980cfe7-61ef-4a5a-9724-881c8a5541e2",
  "processed_at": "2026-08-17T13:10:00.000Z",
  "content": "..."
}

Campo	Tipo	Descripción
success	boolean	Siempre true cuando el HTTP es 200.
document_id	uuid	Identificador del documento consultado, igual al de la URL.
file_name	string	Nombre del archivo original tal como se subió al procesarlo.
schema_id	uuid	Schema que se usó para procesar este documento.
processed_at	datetime (ISO 8601)	Fecha y hora en que se procesó el documento.
content	string	Contenido bruto (texto/markdown) almacenado tras el procesamiento. No es el JSON estructurado del schema.

6. Códigos de error

{
  "error": "Descripción legible del problema.",
  "detalle": "Información técnica adicional (solo presente en algunos casos)."
}

400 — El document_id falta o no tiene formato UUID válido.

401 — Autenticación fallida: key ausente, inexistente, desactivada o cuenta suspendida.

404 — El documento no existe, pertenece a otra cuenta o ha expirado (mismo mensaje genérico por seguridad).

405 — Método distinto de GET. · 500 — Error interno.

7. Resumen de códigos

Código	Categoría	¿Reintentar?
200	Éxito	—
400	Error del cliente (document_id mal formado o ausente)	No, corrige la petición primero
401	Error de autenticación	No, corrige las credenciales primero
404	Documento no encontrado, ajeno o expirado	No, corrige el document_id primero
405	Método HTTP incorrecto	No, corrige el método primero
500	Error interno del servidor	Sí, con precaución

8. Buenas prácticas

Usa siempre el dominio público claix.dev, no la URL directa de Supabase.
Guarda el document_id que devuelvan las extracciones si prevés recuperar el contenido bruto más adelante — no hay endpoint de listado de documentos por ahora.
Esta llamada no se factura ni consume tu cupo de extracciones; úsala para releer contenido, cachear localmente o sincronizar tus sistemas.
Ten en cuenta la expiración (expires_at): si necesitas el contenido a largo plazo, guarda tú una copia del content.
No incluyas tu API key en frontend ni repositorios públicos.