Logo PDFHQ

Documenti

DocumentazioneDocumenti e intelligence

API di modifica pagina PDF in linguaggio semplice

Visualizza in anteprima modifiche di pagina deterministiche e limitate rispetto a un PDF verificato, rivedi la sequenza di output esatta e approva un'attività misurata separatamente da HQTools.

Chiavi API lato server Caricamenti di archiviazione firmati

Anteprima prima di fatturare o modificare un PDF#

Carica e sigilla un PDF utilizzando POST /v1/documents/uploads. Quindi chiama POST /v1/ai/edit-plans/preview con un upload_id di proprietà dell'utente e un'istruzione esplicita sulle pagine. L'anteprima interpreta comandi deterministici; non chiama un modello linguistico né consuma crediti HQ. Le azioni supportate sono rotazione oraria e antioraria, eliminazione, mantenimento, duplicazione, spostamento, inversione e riordinamento delle pagine. Le istruzioni sconosciute vengono rifiutate e non indovinate. Gli originali rimangono invariati.

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

Proposte di pagina opzionali a pagamento, generate dal provider#

Per richieste oltre la formulazione rigorosamente deterministica, un operator-certified La tariffa HQTools potrebbe abilitare l'operazione pdfhq.ai.edit_plan. Questa opzione è disabilitata per impostazione predefinita. Il modello AI restituisce solo un piccolo array di comandi pagina proposti, mai opzioni di elaborazione arbitrarie o byte PDF modificati. Ogni comando deve superare il parser deterministico e ogni affermazione del modello deve avere citazioni. Un suggerimento del modello NON è un'approvazione per modificare il documento.

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.

I suggerimenti dell'IA consumano a separato un addebito in crediti HQ. L'utente deve poi controllare la mappa delle pagine e ottenere un secondo prezzo HQTools per l'attività documentale prima di applicare le modifiche. I risultati del modello AI non possono eludere l'approvazione o riscrivere il contenuto delle pagine. I PDF firmati o con moduli e le revisioni delle fonti modificate o scadute vengono rifiutati.

Ottieni un preventivo HQTools e approva esplicitamente il piano esatto#

Crea POST /v1/tasks con tool organize, quindi allega lo stesso upload verificato utilizzando POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote stima i crediti HQ utilizzando la tariffa HQTools corrente. Solo dopo che il cliente ha rivisto l'elenco delle pagine e il prezzo, chiama POST /v1/tasks/TASK_ID/process con entrambi options.pages dall'anteprima e il suo approval_token firmato.

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

L'approvazione è limitata all'account, al progetto API, all'hash SHA-256 del PDF, all'ID di caricamento, alle opzioni di pagina e alla scadenza breve. La modifica del documento o dell'elenco di pagine invalida questo token. I client di attività standard senza token di anteprima continuano a funzionare. I PDF firmati e i PDF con moduli sono rifiutati da questo editor. Non può riscrivere il testo esistente, nascondere il contenuto in modo sicuro o posizionare firme crittografiche.

Apri l'interfaccia di revisione modifica pagina →
Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.