Logo PDFHQ

Documentos

DocumentaçãoDocumentos e inteligência

API de edição de página PDF em linguagem simples

Visualize edições de página determinísticas e limitadas em relação a um PDF verificado, revise a sequência de saída exata e aprove uma tarefa medida separadamente pelo HQTools.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Visualize antes de faturar ou modificar um PDF#

Fazer upload e selar um PDF usando POST /v1/documents/uploads. Em seguida, chamar POST /v1/ai/edit-plans/preview com um upload_id próprio e uma instrução explícita sobre a página. A pré-visualização interpreta comandos determinísticos; não chama modelos de linguagem nem consome créditos HQ. As ações suportadas são rodar nos dois sentidos, eliminar, manter, duplicar, mover, inverter e reordenar páginas. Instruções desconhecidas são rejeitadas em vez de adivinhadas. Os documentos originais permanecem inalterados.

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

Propostas de página opcionais pagas e geradas pelo provedor#

Para solicitações além da frase determinística estrita, um operator-certified A tarifa HQTools pode ativar a operação pdfhq.ai.edit_plan. Isso está desabilitado por padrão. O modelo de IA retorna apenas um pequeno conjunto de comandos de página propostos, nunca opções de processamento arbitrárias ou bytes PDF editados. Cada comando deve passar pelo analisador determinístico e cada afirmação do modelo deve ter citações. Uma sugestão do modelo NÃO é aprovação para modificar o 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.

As sugestões de IA consomem um separado um débito de créditos HQ. O utilizador deve depois rever o mapa de páginas e obter um segundo preço HQTools para a tarefa documental antes de aplicar as alterações. Os resultados do modelo de IA não podem contornar a aprovação nem reescrever o conteúdo das páginas. São rejeitados PDF assinados ou com formulários e revisões de origem modificadas ou expiradas.

Obtenha uma cotação HQTools e aprove explicitamente o plano exato#

Crie POST /v1/tasks com ferramenta organize, depois anexe o mesmo upload verificado usando POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote estima HQ Credits usando a tarifa HQTools atual. Somente após o cliente revisar a lista de páginas e o preço, chame POST /v1/tasks/TASK_ID/process com options.pages da visualização e seu approval_token assinado.

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

A aprovação é limitada à conta, projeto de API, SHA-256 do PDF, ID de upload, opções de página e expiração curta. Alterar o documento ou lista de páginas invalida este token. Clientes de tarefas padrão sem tokens de visualização continuam funcionando. PDFs assinados e PDFs de formulário são rejeitados por este editor. Não pode reescrever texto existente, ocultar conteúdo com segurança ou colocar assinaturas criptográficas.

Abra a interface de revisão de edição de página →
Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.