Plain-English-PDF-Seiten-Bearbeitungs-API
Vorschau begrenzte, deterministische Seitenbearbeitungen gegen ein verifiziertes PDF, überprüfe die genaue Ausgabesequenz und genehmige eine separat von HQTools gemessene Aufgabe.
Vorschau vor Abrechnung oder PDF-Änderung#
Lade ein PDF hoch und versiegle es mit POST /v1/documents/uploads. Rufe dann auf POST /v1/ai/edit-plans/preview mit einer eigenen upload_id und einer ausdrücklichen Seitenanweisung. Die Vorschau verarbeitet deterministische Befehle; sie ruft kein Sprachmodell auf und verbraucht kein HQ-Guthaben. Unterstützt werden Drehen im oder gegen den Uhrzeigersinn, Löschen, Behalten, Duplizieren, Verschieben, Umkehren und Neuanordnen von Seiten. Unbekannte Anweisungen werden abgelehnt statt erraten. Originaldokumente bleiben unverändert.
POST https://api.pdfhq.io/v1/ai/edit-plans/preview
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"upload_id":"SEALED_UPLOAD_UUID","instruction":"Delete page 3; rotate page 1 clockwise"}
# Response includes tool="organize", options.pages, exact input/output page mapping,
# source_revision, approval_token and approval_expires_at (15 minutes).Optionale, von Anbietern generierte Seitenvorschläge#
Für Anfragen über die strikte deterministische Formulierung hinaus, ein operator-certified HQTools-Tarif kann Operation aktivieren pdfhq.ai.edit_plan. Dies ist standardmäßig deaktiviert. Das KI-Modell gibt nur ein kleines Array vorgeschlagener Seitenbefehle zurück, niemals beliebige Verarbeitungsoptionen oder bearbeitete PDF-Bytes. Jeder Befehl muss den deterministischen Parser passieren und jede Modellbehauptung muss Zitate haben. Ein Modellvorschlag ist KEINE Genehmigung zur Änderung des Dokuments.
# Discover only activated HQTools tariffs for pdfhq.ai.edit_plan
GET https://api.pdfhq.io/v1/ai/billing/prices
POST https://api.pdfhq.io/v1/ai/billing/quotes
{"price_id":"CERTIFIED_AI_EDIT_PLAN_PRICE_ID","quantity":"1"}
# Only AFTER explicit approval of the HQ-credit quote and excerpt sharing:
POST https://api.pdfhq.io/v1/ai/jobs
Idempotency-Key: STABLE_RANDOM_IDEMPOTENCY_KEY
{"operation":"pdfhq.ai.edit_plan","upload_id":"SEALED_UPLOAD_UUID",
"quote_id":"AI_QUOTE_ID","question":"Rotate the appendix page clockwise",
"allow_external_ai":true,"allow_ocr":false}
GET https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID
# Upon success, validate the proposed commands against the ORIGINAL sealed PDF:
POST https://api.pdfhq.io/v1/ai/edit-plans/from-job
{"job_id":"AI_JOB_UUID"}
# Returns exact page map and 15-minute user-review token, NOT a paid editing job.KI-Vorschläge verbrauchen ein getrennt eine Belastung mit HQ-Guthaben. Anschließend muss der Benutzer die Seitenanordnung prüfen und ein zweites HQTools-Preisangebot für den Dokumentauftrag einholen, bevor die Änderungen angewendet werden. KI-Ergebnisse dürfen weder die Genehmigung umgehen noch Seiteninhalte umschreiben. Signierte oder Formular-PDFs sowie geänderte oder abgelaufene Quellversionen werden abgelehnt.
Hole ein HQTools-Angebot und genehmige explizit den genauen Plan#
Erstelle POST /v1/tasks mit Tool organize, dann füge denselben verifizierten Upload mit POST /v1/tasks/TASK_ID/files an. GET /v1/tasks/TASK_ID/quote schätzt HQ Credits mit dem aktuellen HQTools-Tarif. Nur nachdem der Kunde die Seitenliste und den Preis überprüft hat, rufe POST /v1/tasks/TASK_ID/process mit beiden options.pages aus der Vorschau und seinem signierten approval_token auf.
POST https://api.pdfhq.io/v1/tasks
{"tool":"organize"}
POST https://api.pdfhq.io/v1/tasks/TASK_ID/files
{"upload_id":"SEALED_UPLOAD_UUID"}
GET https://api.pdfhq.io/v1/tasks/TASK_ID/quote
POST https://api.pdfhq.io/v1/tasks/TASK_ID/process
{"options":{"pages":[{"source":1,"rotation":90},{"source":2,"rotation":0}]},
"approval_token":"SIGNED_PREVIEW_APPROVAL"}
GET https://api.pdfhq.io/v1/tasks/TASK_ID
GET https://api.pdfhq.io/v1/tasks/TASK_ID/download-urlDie Genehmigung ist auf Konto, API-Projekt, PDF SHA-256, Upload-ID, Seitenoptionen und kurze Gültigkeitsdauer begrenzt. Das Ändern des Dokuments oder der Seitenliste macht diesen Token ungültig. Standard-Task-Clients ohne Vorschau-Tokens funktionieren weiterhin. Signierte PDFs und Formular-PDFs werden von diesem Editor abgelehnt. Er kann bestehenden Text nicht umschreiben, Inhalte nicht sicher ausblenden oder kryptografische Signaturen platzieren.
Öffne die Seiten-Bearbeitungs-Überprüfungsschnittstelle →