Qué usar

Constaia ofrece varias formas de procesar documentos. Todas usan la misma API y las mismas claves; cambian el coste, la latencia y quién sube el fichero.

ResumenCopy Anchor Link

Cómo decidirCopy Anchor Link

Puedes combinarlas: por ejemplo, classify para decidir el tipo y después analyze con el expect adecuado, o el widget en el formulario y lotes para las importaciones masivas.

CosteCopy Anchor Link

• analyze: ceil(páginas / 2) créditos, mínimo 1. Un DNI con las dos caras en un fichero o un PDF de 2 páginas cuesta 1 crédito; un PDF de 5 páginas, 3.
• classify: 0,2 créditos por documento.
• Lotes: cada documento se cobra como un analyze. En modo live se comprueba antes que tengas al menos 1 crédito por documento (si no, 402).
• Las exportaciones van incluidas. El modo test no cobra nunca.

Ver Créditos y facturación y Precios.

LatenciaCopy Anchor Link

• analyze y classify esperan hasta 30 segundos. Si el análisis no ha terminado, responden 202 con el análisis en queued o processing y el resultado llega por webhook o consultando GET /v1/analyses/{id}.
• Con async: true la respuesta es siempre 202 inmediata.
• Los lotes son siempre asíncronos: recibes analysis.review_required y analysis.failed por documento y un único batch.completed al final.

LímitesCopy Anchor Link

EjemplosCopy Anchor Link

analyzeCopy Anchor Link

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F file=@dni_valid.jpg \
  -F 'options={"expect":"es_dni","checks":{"min_age_years":18}}'

Devuelve el análisis completo: document, verdict, fields, checks, warnings. Ver Inicio rápido.

classifyCopy Anchor Link

curl https://api.constaia.com/v1/classify \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F file=@dni_valid.jpg \
  -F 'options={"expect":"es_dni"}'

{
  "object": "classification",
  "status": "completed",
  "document": { "type": "es_dni", "label": "DNI (España)", "confidence": 0.97, "side": "both", "country": "ESP" },
  "candidates": [{ "type": "es_dni", "confidence": 0.97 }],
  "verdict": {
    "expected": ["es_dni"],
    "match": true,
    "status": "valid",
    "reasons": [{ "code": "type_match", "severity": "info", "message": "El documento es DNI (España)." }]
  },
  "warnings": []
}

El veredicto de classify solo evalúa el tipo (type_match o type_mismatch): no comprueba caducidad ni extrae campos.

LoteCopy Anchor Link

curl https://api.constaia.com/v1/batches \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "files[]=@factura-001.pdf" \
  -F "files[]=@factura-002.pdf" \
  -F 'options={"expect":"invoice","export":["xlsx"]}'

Responde 202 con un objeto batch (bat_...) en processing. Cuando termina recibes batch.completed con counts y la exportación combinada en exports.xlsx, una fila por documento. Ver Lotes masivos.

WidgetCopy Anchor Link

<script type="module" src="https://cdn.jsdelivr.net/npm/@constaia/widget@0.1"></script>

<constaia-upload endpoint="/api/constaia" document="es_dni" lang="es"></constaia-upload>

El widget nunca lleva la clave: envía el fichero a tu endpoint (/api/constaia), y es tu backend el que llama a POST /v1/analyze con el expect y los checks que decida. Ver Widget.

MCPCopy Anchor Link

claude mcp add constaia --env CONSTAIA_API_KEY=ck_test_... -- npx -y @constaia/mcp

Expone las herramientas analyze_document, classify_document, list_document_types, get_analysis y get_balance. Ver Servidor MCP.

No-codeCopy Anchor Link

En n8n, Make, Zapier o Power Automate usas el módulo HTTP de la herramienta para llamar a POST /v1/analyze. Ver las guías de n8n, Make y Zapier.

Siguientes pasosCopy Anchor Link