Imagen a JSON

Extrae datos estructurados de una imagen según un schema

Recibe una imagen (.jpeg, .jpg, .png, .webp, .heic o .heif) y un schema_id, y devuelve un único objeto JSON con los datos extraídos del contenido visible, con las claves exactamente iguales a las propiedades definidas en el schema. El análisis lo realiza un modelo multimodal de IA. Antes de extraer datos, el modelo evalúa si la imagen es legible (nitidez, enfoque, iluminación); si no lo es, responde con 422. Igual que en pdf-json, la imagen se trata como una única fuente de datos: la respuesta siempre contiene exactamente un registro en "data". El tamaño máximo de archivo admitido es 15 MB. La respuesta incluye log_id. Si la verificación de fuente está activada en el schema, cada propiedad extraída es { value, source }.

post/img-json

Request

  • Base URL: https://claix.dev/api
  • URL: https://claix.dev/api/img-json
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Response

Imagen analizada y datos extraídos correctamente

successboolean
schema_utilizadostring

Nombre del schema aplicado.

total_registrosinteger

Siempre 1 en este endpoint: la imagen completa se trata como una única fuente de datos, no como una tabla de múltiples filas.

dataobject[]

Contiene exactamente un objeto con los datos extraídos de la imagen, según las propiedades definidas en el schema. Los datos no encontrados se devuelven como null. Si la verificación de fuente está activada en el schema, cada propiedad es { value, source } (zona o etiqueta visible).

log_idstring uuid nullable

Identificador del registro en usage_logs de esta llamada. Presente en respuestas de éxito de extracción, modo agente, document-context y space-context, y en la mayoría de errores una vez autenticada la petición. Puede omitirse si el insert del log falla.

Example response

{
  "success": true,
  "schema_utilizado": "Facturas de Proveedores",
  "total_registros": 1,
  "data": [
    {
      "numero_factura": "F-2026-00456",
      "fecha_emision": "2026-03-14",
      "proveedor": "Suministros Industriales del Ebro S.L.",
      "importe_total": 1284.5,
      "moneda": "EUR"
    }
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Changes

No recorded changes to this operation across all 1 revision of this API.