Logotipo de PDFHQ

Documentos

DocumentaciónDocumentos e inteligencia

Ciclo de vida del trabajo de IA

Cotiza → verifica fuente → inicia un trabajo de IA asincrónico → consulta citas validadas y descarga resultados estructurados.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

De extremo a extremo: cotización, reserva, procesamiento, liquidación#

Las operaciones de IA siguen la misma admisión de PDF verificada que las tareas convencionales. Se requieren un precio de IA de HQTools activo y una cotización con alcance de cuenta para cantidad 1. A diferencia de las herramientas PDF, un trabajo de IA cotizado se envía a POST /v1/ai/jobs y avanza por un registro duradero independiente. PDFHQ reserva créditos HQ en el proceso de trabajo ANTES de contactar al proveedor y los liquida solo después de almacenar el resultado. Esta función está desactivada por defecto hasta verificar las condiciones para lanzarla en producción.

cURL
# 1. Upload and seal your PDF using /v1/documents/uploads
# 2. Inspect prices and create a quote
curl 'https://api.pdfhq.io/v1/ai/billing/prices' -H 'x-api-key: PROJECT_API_KEY'
curl -X POST 'https://api.pdfhq.io/v1/ai/billing/quotes' \
  -H 'x-api-key: PROJECT_API_KEY' -H 'Content-Type: application/json' \
  -d '{"price_id":"ACTIVE_PRICE_ID","quantity":"1"}'
# 3. Submit one immutable job
curl -X POST 'https://api.pdfhq.io/v1/ai/jobs' \
  -H 'x-api-key: PROJECT_API_KEY' -H 'Idempotency-Key: your-stable-request-key-123' \
  -H 'Content-Type: application/json' \
  -d '{"operation":"pdfhq.ai.chat","upload_id":"UPLOAD_UUID","quote_id":"QUOTE_ID","question":"What is the payment deadline?","allow_ocr":false,"allow_external_ai":true}'
# 4. Poll the result
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID' -H 'x-api-key: PROJECT_API_KEY'

Estado legible por máquina#

Factura por lotes que los usuarios pueden abrir el espacio de trabajo de revisión de lotes de facturas . El navegador orquesta hasta diez cotizado independientemente e idempotentetareas `pdfhq.ai.extract` con créditos HQ. No existe un descuento por lotes inventado, un punto de acceso API con precio por lote ni reintentos automáticos cuando el resultado del proveedor es incierto. Cada fila permite exportar campos de factura verificados, partidas y extractos de origen citados para revisión humana.

En cola → reservando → ejecutando → liquidando → completada. Las tareas fallidas liberan sus créditos HQ reservados cuando se sabe que el proveedor no completó la operación. El estado needs_reconciliation indica un resultado incierto del proveedor: NO vuelvas a enviar automáticamente una nueva tarea. Reintentar con la misma clave de idempotencia recupera la misma tarea lógica. Usa GET /v1/ai/jobs para listar tareas y DELETE /v1/ai/jobs/{id} para borrar el contenido del terminal mientras se conservan los recibos de facturación sin contenido.

Las claves de proyecto de IA requieren el alcance pdfhq.ai.execute y el derecho api.enabled; la cotización utiliza pdfhq.ai.quote. Las sesiones del navegador utilizan una cuenta HQ protegida por CSRF.

Logotipo de PDFHQ

Herramientas PDF y análisis de documentos. Prepara, comprende y trabaja con tus documentos.

© 2026 PDFHQ. Todos los derechos reservados.