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