Chat con API PDF
Rispondi alle domande sui PDF con prove vincolate alla revisione ed etichettate per pagina utilizzando modelli di IA approvati e accettazione obbligatoria delle citazioni.
Risposta a domande basata sul PDF di origine#
Usa operazione pdfhq.ai.chat con domanda fino a 2.000 caratteri, caricamenti verificati e preventivo HQTools corrispondente. La chat su singolo PDF richiede quantità 1. La chat multi-documento opzionale supporta fino a quattro PDF quando attivata dopo la certificazione della tariffa HQTools. Sigilla prima ogni PDF; la quantità del preventivo deve corrispondere al numero di documenti. Tutti i caricamenti appartengono allo stesso account e progetto API; insieme devono totalizzare al massimo 12 MiB. Il worker classifica gli estratti immutabili tra le fonti e rifiuta gli ID di citazione non supportati o fabbricati.
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-idempotency-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"UPLOAD_UUID","quote_id":"QUOTE_ID","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Chat multi-documento (quando disponibile)#
GET /v1/ai/billing/prices indica multi_document_available, disabilitato per impostazione predefinita. Per tre PDF caricati, richiedi un preventivo chat attivo con quantità 3. Il caricamento originale è il Documento 1; additional_upload_ids sono i Documenti 2 e 3.
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"3"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-multi-source-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"PDF_1_UUID","additional_upload_ids":["PDF_2_UUID","PDF_3_UUID"],"quote_id":"QUOTE_WITH_QUANTITY_3","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Il riutilizzo di una chiave di idempotenza con un set di origine diverso restituisce 409. Le revisioni di origine mancanti o modificate, i caricamenti tra account o una quota insufficiente vengono rifiutati prima dell'inferenza del provider. Le citazioni identificano il documento di origine e la pagina PDF originale.
Conversazioni private multi-turno (fino a quattro turni)#
Continua una chat riuscita senza caricare di nuovo i PDF. Ogni follow-up richiede un nuovo preventivo, consenso e una nuova chiave di idempotenza. Passa previous_job_id ma ometti upload_id e additional_upload_ids: il backend eredita esattamente le stesse fonti PDF verificate SHA-256 di proprietà dell'account e del progetto. Un follow-up multi-documento richiede un preventivo corrispondente in quantità per tutti i PDF ereditati. Riutilizzare il vecchio preventivo o modificare i documenti non è una scorciatoia consentita.
# Review cited results, then quote the NEXT turn
GET https://api.pdfhq.io/v1/ai/jobs/FIRST_CHAT_JOB_UUID/conversation
x-api-key: PROJECT_API_KEY
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"1"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: unique-follow-up-request-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","previous_job_id":"FIRST_CHAT_JOB_UUID","quote_id":"NEW_QUOTE_ID","question":"What happens if that payment is late?","allow_external_ai":true,"allow_ocr":false}È possibile includere solo fino a tre turni precedenti. Le risposte precedenti sono contesto conversazionale inaffidabile, non prove documentali: le citazioni nuove devono puntare agli attuali estratti PDF verificati. I risultati cancellati o scaduti e i progetti API stranieri non possono essere riutilizzati. Avvia una nuova chat per modificare i documenti di origine.
Le risposte generate dal modello devono essere verificate. Il sistema verifica gli ID di citazione, non la verità dell'inferenza. Testo mancante, scansioni scadenti e contesto recuperato limitato possono rendere impossibile una risposta corretta.
