Logo PDFHQ

Documents

DocumentationDocuments et intelligence

API d'édition de page PDF en langage clair

Prévisualisez les modifications de page déterministes et délimitées par rapport à un PDF vérifié, examinez la séquence de sortie exacte et approuvez une tâche mesurée séparément par HQTools.

Clés API côté serveur Importations de stockage signées

Prévisualiser avant facturation ou modification d'un PDF#

Importer et sceller un PDF en utilisant POST /v1/documents/uploads. Puis appeler POST /v1/ai/edit-plans/preview avec un upload_id appartenant à l’utilisateur et une instruction de page explicite. L’aperçu interprète des commandes déterministes ; il n’appelle aucun modèle de langage et ne dépense aucun crédit HQ. Les actions prises en charge sont la rotation horaire ou antihoraire, la suppression, la conservation, la duplication, le déplacement, l’inversion et la réorganisation des pages. Les instructions inconnues sont rejetées et non devinées. Les originaux restent inchangés.

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

Propositions de page payantes optionnelles générées par le fournisseur#

Pour les demandes au-delà de la formulation strictement déterministe, un operator-certified Le tarif HQTools peut activer l'opération pdfhq.ai.edit_plan. Cette option est désactivée par défaut. Le modèle IA retourne uniquement un petit tableau de commandes de page proposées, jamais d'options de traitement arbitraires ou d'octets PDF modifiés. Chaque commande doit passer l'analyseur déterministe et chaque affirmation du modèle doit avoir des citations. Une suggestion du modèle N'EST PAS une approbation pour modifier le document.

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.

Les suggestions IA consomment un séparé un débit en crédits HQ. L’utilisateur doit ensuite examiner la disposition des pages et obtenir un second tarif de tâche documentaire HQTools pour appliquer les modifications. Les résultats de l’IA ne peuvent ni contourner l’approbation ni réécrire le contenu des pages. Les PDF signés ou contenant des formulaires ainsi que les versions sources modifiées ou expirées sont refusés.

Obtenez un devis HQTools et approuvez explicitement le plan exact#

Créez POST /v1/tasks avec l'outil organize, puis joignez le même import vérifié en utilisant POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote estime les crédits HQ en utilisant le tarif HQTools actuel. Seulement après que le client ait examiné la liste des pages et le prix, appelez POST /v1/tasks/TASK_ID/process avec options.pages et son approval_token signé.

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'approbation est limitée au compte, au projet API, au SHA-256 du PDF, à l'ID d'importation, aux options de page et à l'expiration courte. La modification du document ou de la liste des pages invalide ce jeton. Les clients de tâches standard sans jetons d'aperçu continuent de fonctionner. Les PDF signés et les PDF de formulaire sont rejetés par cet éditeur. Il ne peut pas réécrire le texte existant, masquer le contenu de manière sécurisée ou placer des signatures cryptographiques.

Ouvrir l'interface d'examen de modification de page →
Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.