PDFHQ-logo

Documenten

DocumentatieDocumenten en intelligentie

AI-taaklevenscyclus

Offerte → bron verifiëren → asynchrone AI-taak starten → geverifieerde citaten opvragen en gestructureerde resultaten downloaden.

Server-side API-sleutels Ondertekende opslagupload

End-to-end: offerte, reservering, verwerking, afwikkeling#

AI-bewerkingen volgen dezelfde geverifieerde PDF-toelating als conventionele taken. Een actieve HQTools AI-prijs en een accountbereik-offerte voor hoeveelheid 1 zijn vereist. In tegenstelling tot PDF-hulpmiddelen wordt een aangeboden AI-taak ingediend bij POST /v1/ai/jobs en doorloopt een afzonderlijk duurzaam grootboek. PDFHQ reserveert HQ-tegoed in de worker VOORDAT de aanbieder wordt benaderd en rekent pas af nadat het resultaat is opgeslagen. Deze functie staat standaard uit totdat de voorwaarden voor productie-uitrol zijn gecontroleerd.

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'

Machineleesbare status#

Batchfactuurgebruikers kunnen openen de werkruimte voor batchbeoordeling van facturen . De browser orkestreert tot tien onafhankelijk aangehaald en idempotent`pdfhq.ai.extract`-taken met HQ-tegoed. Er is geen verzonnen bulkkorting, per batch geprijsd API-eindpunt of automatische herhaling wanneer de aanbiederuitkomst onzeker is. Elke rij kan geverifieerde factuurvelden, regels en aangehaalde bronfragmenten exporteren voor menselijke controle.

In wachtrij → reserveren → uitvoeren → afrekenen → geslaagd. Mislukte taken geven de HQ-tegoedreservering vrij wanneer zeker is dat de aanbieder niet succesvol is afgerond. De status needs_reconciliation betekent dat de uitkomst onzeker is: dien NIET automatisch opnieuw een taak in. Opnieuw proberen met dezelfde idempotentiesleutel herstelt dezelfde logische taak. Gebruik GET /v1/ai/jobs voor de lijst en DELETE /v1/ai/jobs/{id} om terminalinhoud te wissen terwijl factureringsbewijzen behouden blijven.

AI-projectsleutels hebben pdfhq.ai.execute scope en api.enabled entitlement nodig; offerteverzoek gebruikt pdfhq.ai.quote. Browsersessies gebruiken een CSRF-beveiligd HQ-account.

PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.