KI-Job-Lebenszyklus
Angebot → Quelle verifizieren → asynchronen KI-Job starten → validierte Zitate abfragen und strukturierte Ergebnisse herunterladen.
End-to-End: Angebot, Reservierung, Verarbeitung, Abrechnung#
KI-Operationen folgen der gleichen verifizierten PDF-Zulassung wie herkömmliche Tasks. Ein aktiver HQTools-KI-Preis und ein kontengebundenes Angebot für Menge 1 sind erforderlich. Im Gegensatz zu PDF-Tools wird ein angebotener KI-Job an POST /v1/ai/jobs und durchläuft ein separates dauerhaftes Journal. PDFHQ reserviert HQ-Guthaben im Worker VOR dem Aufruf des Anbieters und rechnet erst nach dem Speichern des Ergebnisses ab. Diese Funktion bleibt standardmäßig deaktiviert, bis die Produktionsfreigaben geprüft sind.
# 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'Maschinenlesbarer Status#
Batch-Rechnungsbenutzer können öffnen der Rechnungs-Batch-Review-Arbeitsbereich . Der Browser orchestriert bis zu zehn unabhängig angeboten und idempotent`pdfhq.ai.extract`-Aufträge mit HQ-Guthaben. Es gibt weder erfundene Mengenrabatte noch einen nach Stapeln bepreisten API-Endpunkt oder automatische Wiederholungen bei unklarem Anbieterergebnis. Jede Zeile kann geprüfte Rechnungsfelder, Positionen und zitierte Quellauszüge zur menschlichen Kontrolle exportieren.
Wartend → Reservierung → Ausführung → Abrechnung → Erfolgreich. Fehlgeschlagene Aufträge geben ihre HQ-Guthabenreservierung frei, wenn sicher ist, dass der Anbieter nicht erfolgreich abgeschlossen hat. needs_reconciliation bedeutet, dass das Anbieterergebnis unklar ist: NICHT automatisch erneut senden. Ein erneuter Versuch mit demselben Idempotenzschlüssel stellt denselben logischen Auftrag wieder her. GET /v1/ai/jobs listet Aufträge auf und DELETE /v1/ai/jobs/{id} um Terminalinhalte zu löschen und gleichzeitig Abrechnungsbelege zu bewahren.
AI-Projektschlüssel benötigen den Bereich pdfhq.ai.execute und die Berechtigung api.enabled; Angebote verwenden pdfhq.ai.quote. Browser-Sitzungen verwenden ein CSRF-geschütztes HQ-Konto.
