PDFHQ-Logo

Dokumente

DokumentationDokumente & Intelligenz

Chatten Sie mit der PDF-API

Beantworte PDF-Fragen mit revisionsbezogenen, seitennummerierten Belegen unter Verwendung genehmigter KI-Modelle und obligatorischer Zitatenannahme.

Server-seitige API-Schlüssel Signierte Speicher-Uploads

Fragen beantworten, die im Quell-PDF verankert sind#

Verwende Operation pdfhq.ai.chat mit Frage bis zu 2.000 Zeichen, verifizierten Uploads und übereinstimmendem HQTools-Angebot. Single-PDF-Chat erfordert Menge 1. Optionaler Multi-Dokument-Chat unterstützt bis zu vier PDFs nach HQTools-Tarif-Zertifizierung. Versiegle jede PDF zuerst; die Angebotsmenge muss der Dokumentanzahl entsprechen. Alle Uploads gehören zum selben Konto und API-Projekt; zusammen dürfen sie maximal 12 MiB betragen. Der Worker ordnet unveränderliche Auszüge über Quellen hinweg und lehnt nicht unterstützte oder erfundene Zitat-IDs ab.

cURL
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}

Multi-Dokument-Chat (wenn verfügbar)#

GET /v1/ai/billing/prices meldet multi_document_available, das standardmäßig deaktiviert ist. Für drei hochgeladene PDFs fordern Sie ein aktives Chat-Tarifangebot mit Menge 3 an. Der ursprüngliche Upload ist Dokument 1; additional_upload_ids sind Dokumente 2 und 3.

cURL
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}

Das Wiederverwenden eines Idempotenz-Schlüssels mit einem anderen Quellensatz gibt 409 zurück. Fehlende oder geänderte Quellrevisionen, kontoübergreifende Uploads oder unzureichende Kontingente werden vor der Anbieterinferenz abgelehnt. Zitate identifizieren das Quelldokument und die ursprüngliche PDF-Seite.

Private Mehrfach-Gespräche (bis zu vier Durchläufe)#

Setze ein erfolgreiches Chat fort, ohne die PDFs erneut hochzuladen. Jede Nachverfolgung benötigt ein neues Angebot, eine Zustimmung und einen neuen Idempotency-Schlüssel. Übergebe previous_job_id, aber lasse upload_id und additional_upload_ids weg: das Backend erbt genau dieselben konto- und projektbezogenen, SHA-256-verifizierten PDF-Quellen. Eine mehrdokumentale Nachverfolgung erfordert ein mengenabgestimmtes Angebot für alle geerbten PDFs. Die Wiederverwendung des alten Angebots oder das Ändern von Dokumenten ist keine zulässige Abkürzung.

cURL
# 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}

Maximal drei vorherige Turns können eingebunden werden. Frühere Antworten sind nicht vertrauenswürdiger Gesprächskontext, keine dokumentarischen Belege: Neue Zitate müssen auf aktuelle verifizierte PDF-Auszüge verweisen. Gelöschte oder abgelaufene Ergebnisse und fremde API-Projekte können nicht wiederverwendet werden. Starten Sie einen neuen Chat, um die Quelldokumente zu ändern.

Antworten werden von Modellen generiert und müssen überprüft werden. Das System verifiziert Zitations-IDs, nicht die Wahrheit der Inferenz. Fehlender Text, schlechte Scans und begrenzte abgerufene Kontexte können eine korrekte Antwort unmöglich machen.

PDFHQ-Logo

PDF-Werkzeuge und Dokumentenanalyse. Dokumente vorbereiten, verstehen und bearbeiten.

© 2026 PDFHQ. Alle Rechte vorbehalten.