PDFHQ-logo

Documenten

DocumentatieDocumenten en intelligentie

Plain-English PDF-pagina-bewerkings-API

Bekijk begrensd, deterministische paginabewerkingen tegen een geverifieerde PDF, controleer de exacte uitvoervolgorde en keur een afzonderlijk HQTools-gemeten taak goed.

Server-side API-sleutels Ondertekende opslagupload

Voorbeeld bekijken voordat u een PDF factureert of wijzigt#

Upload en verzegel een PDF met POST /v1/documents/uploads. Roep vervolgens aan POST /v1/ai/edit-plans/preview met een eigen upload_id en een expliciete pagina-instructie. Het voorbeeld verwerkt deterministische opdrachten; het roept geen taalmodel aan en verbruikt geen HQ-tegoed. Ondersteunde acties zijn linksom of rechtsom draaien, verwijderen, behouden, dupliceren, verplaatsen, omkeren en opnieuw ordenen van pagina's. Onbekende instructies worden geweigerd in plaats van geraden. Originele documenten blijven ongewijzigd.

cURL
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).

Optionele betaalde, door provider gegenereerde paginavoorstellen#

Voor verzoeken buiten de strikte deterministische formulering, een operator-certified HQTools-tarief kan bewerking inschakelen pdfhq.ai.edit_plan. Dit is standaard uitgeschakeld. Het AI-model retourneert alleen een kleine reeks voorgestelde paginaopdrachten, nooit willekeurige verwerkingsopties of bewerkte PDF-bytes. Elke opdracht moet de deterministische parser doorstaan en elke modelclaim moet citaten hebben. Een modelsuggestie is GEEN goedkeuring om het document te wijzigen.

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

AI-suggesties verbruiken een gescheiden een afschrijving van HQ-tegoed. De gebruiker moet vervolgens de pagina-indeling beoordelen en een tweede HQTools-prijsopgave voor de documenttaak verkrijgen voordat de wijzigingen worden toegepast. AI-resultaten mogen de goedkeuring niet omzeilen of paginainhoud herschrijven. Ondertekende of formulier-PDF's en gewijzigde of verlopen bronrevisies worden geweigerd.

Vraag een HQTools-offerte aan en keur het exacte plan expliciet goed#

Maak POST /v1/tasks met tool organize, voeg vervolgens dezelfde geverifieerde upload toe met POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote schat HQ Credits met behulp van het huidige HQTools-tarief. Alleen nadat de klant de paginalist en prijs heeft beoordeeld, roept u POST /v1/tasks/TASK_ID/process aan met zowel options.pages uit preview als de ondertekende approval_token.

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

Goedkeuring is beperkt tot account, API-project, PDF SHA-256, upload-ID, paginaopties en korte vervaldatum. Het wijzigen van het document of de paginalist maakt dit token ongeldig. Standaard taakclients zonder voorbeeldtokens blijven werken. Ondertekende PDF's en formulier-PDF's worden door deze editor afgewezen. Het kan bestaande tekst niet herschrijven, inhoud niet veilig verbergen of cryptografische handtekeningen plaatsen.

Open de pagina-bewerkingsbeoordelingsinterface →
PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.