API de edición de páginas PDF en inglés simple
Previsualiza ediciones de página deterministas y acotadas contra un PDF verificado, revisa la secuencia exacta de salida y aprueba una tarea medida por HQTools por separado.
Obtén una vista previa antes de facturar o modificar un PDF#
Carga y sella un PDF usando POST /v1/documents/uploads. Luego llama a POST /v1/ai/edit-plans/preview con un upload_id propio y una instrucción de página explícita. La vista previa interpreta órdenes deterministas; no invoca ningún modelo de lenguaje ni consume créditos HQ. Las acciones admitidas incluyen girar en ambos sentidos, eliminar, conservar, duplicar, mover, invertir y reordenar páginas. Las instrucciones desconocidas se rechazan en lugar de adivinarse. Los documentos originales permanecen intactos.
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).Propuestas de página generadas por proveedor, opcionales y pagadas#
Para solicitudes más allá de la redacción estrictamente determinista, se requiere un operator-certified La tarifa de HQTools puede habilitar la operación pdfhq.ai.edit_plan. Esto está deshabilitado de forma predeterminada. El modelo de IA devuelve solo una pequeña matriz de comandos de página propuestos, nunca opciones de procesamiento arbitrarias o bytes PDF editados. Cada comando debe pasar el analizador determinista y cada afirmación del modelo debe tener citas. Una sugerencia del modelo NO es aprobación para modificar el documento.
# 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.Las sugerencias de IA consumen una separar un cargo en créditos HQ. Después, el usuario debe revisar el mapa de páginas y obtener un segundo precio de tarea documental de HQTools para aplicar los cambios. Los resultados del modelo de IA no pueden eludir la aprobación ni reescribir el contenido de las páginas. Se rechazan los PDF firmados o con formularios y las revisiones originales modificadas o caducadas.
Obtén una cotización de HQTools y aprueba explícitamente el plan exacto#
Crea POST /v1/tasks con herramienta organize, luego adjunta la misma carga verificada usando POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote estima HQ Credits usando la tarifa actual de HQTools. Solo después de que el cliente revise la lista de páginas y el precio, llama a POST /v1/tasks/TASK_ID/process con options.pages del preview y su approval_token firmado.
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-urlLa aprobación se limita a la cuenta, proyecto de API, SHA-256 del PDF, ID de carga, opciones de página y vencimiento corto. Cambiar el documento o la lista de páginas invalida este token. Los clientes de tareas estándar sin tokens de vista previa continúan funcionando. Los PDF firmados y los PDF de formularios se rechazan en este editor. No puede reescribir texto existente, ocultar contenido de forma segura ni colocar firmas criptográficas.
Abrir la interfaz de revisión de edición de página →