Ciclo di vita del job AI
Preventivo → verifica fonte → avvia un job IA asincrono → esegui il polling delle citazioni validate e scarica i risultati strutturati.
End-to-end: preventivo, prenotazione, elaborazione, liquidazione#
Le operazioni AI seguono la stessa ammissione PDF verificata dei compiti convenzionali. Sono richiesti un prezzo AI HQTools attivo e un preventivo con ambito account per quantità 1. A differenza degli strumenti PDF, un job AI quotato viene inviato a POST /v1/ai/jobs e procede attraverso un registro durevole separato. PDFHQ riserva i crediti HQ nel worker PRIMA di contattare il fornitore e li liquida solo dopo aver salvato il risultato. La funzione è disabilitata per impostazione predefinita finché non saranno verificati i requisiti per il rilascio in produzione.
# 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'Stato leggibile da macchina#
Gli utenti di fatture batch possono aprire l'area di lavoro di revisione batch fatture . Il browser orchestra fino a dieci quotato indipendentemente e idempotenteattività `pdfhq.ai.extract` con crediti HQ. Non esistono sconti per lotti inventati, endpoint API con prezzo per lotto o ritentativi automatici in caso di esito incerto del fornitore. Ogni riga può esportare campi fattura verificati, voci e citazioni della fonte per la revisione umana.
In coda → prenotazione → esecuzione → liquidazione → completata. Le attività non riuscite liberano i crediti HQ riservati quando si sa che il fornitore non ha completato l'operazione. Lo stato needs_reconciliation indica un esito incerto del fornitore: NON inviare automaticamente una nuova attività. Riprovare con la stessa chiave di idempotenza recupera la stessa attività logica. Usa GET /v1/ai/jobs per elencare i lavori e DELETE /v1/ai/jobs/{id} per cancellare il contenuto del terminale preservando le ricevute di fatturazione non contenutistiche.
Le chiavi di progetto AI richiedono l'ambito pdfhq.ai.execute e l'entitlement api.enabled; la quotazione utilizza pdfhq.ai.quote. Le sessioni del browser utilizzano un account HQ protetto da CSRF.
