Logo PDFHQ

Documentos

DocumentaçãoDocumentos e inteligência

Ciclo de vida do trabalho de IA

Cotação → verificar fonte → iniciar uma tarefa de IA assíncrona → pesquisar citações validadas e fazer download de resultados estruturados.

Chaves de API do lado do servidor Uploads de armazenamento assinado

De ponta a ponta: cotação, reserva, processamento, liquidação#

Operações de IA seguem a mesma admissão verificada de PDF que tarefas convencionais. Um preço de IA ativo do HQTools e uma cotação com escopo de conta para quantidade 1 são necessários. Diferentemente das ferramentas PDF, um trabalho de IA cotado é enviado para POST /v1/ai/jobs e progride num registo durável separado. O PDFHQ reserva créditos HQ no processo de trabalho ANTES de contactar o fornecedor e só liquida depois de armazenar o resultado. A funcionalidade está desativada por predefinição até serem verificadas as condições de lançamento em produção.

cURL
# 1. Upload and seal your PDF using /v1/documents/uploads
# 2. Inspect prices and create a quote
curl 'https://api.pdfhq.io/v1/ai/billing/prices' -H 'x-api-key: PROJECT_API_KEY'
curl -X POST 'https://api.pdfhq.io/v1/ai/billing/quotes' \
  -H 'x-api-key: PROJECT_API_KEY' -H 'Content-Type: application/json' \
  -d '{"price_id":"ACTIVE_PRICE_ID","quantity":"1"}'
# 3. Submit one immutable job
curl -X POST 'https://api.pdfhq.io/v1/ai/jobs' \
  -H 'x-api-key: PROJECT_API_KEY' -H 'Idempotency-Key: your-stable-request-key-123' \
  -H 'Content-Type: application/json' \
  -d '{"operation":"pdfhq.ai.chat","upload_id":"UPLOAD_UUID","quote_id":"QUOTE_ID","question":"What is the payment deadline?","allow_ocr":false,"allow_external_ai":true}'
# 4. Poll the result
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID' -H 'x-api-key: PROJECT_API_KEY'

Status legível por máquina#

Usuários de fatura em lote podem abrir o espaço de trabalho de revisão de lote de faturas . O navegador orquestra até dez cotado independentemente e idempotentetarefas `pdfhq.ai.extract` com créditos HQ. Não há descontos de lote inventados, pontos de acesso API com preços por lote nem repetição automática quando o resultado do fornecedor é incerto. Cada linha pode exportar campos de fatura verificados, itens e excertos de origem citados para revisão humana.

Em fila → reserva → execução → liquidação → concluída. As tarefas falhadas libertam os créditos HQ reservados quando se sabe que o fornecedor não concluiu com sucesso. O estado needs_reconciliation indica um resultado incerto do fornecedor: NÃO reenvie automaticamente uma nova tarefa. Repetir com a mesma chave de idempotência recupera a mesma tarefa lógica. Use GET /v1/ai/jobs para listar tarefas e DELETE /v1/ai/jobs/{id} para apagar o conteúdo do terminal preservando recibos de faturamento não relacionados ao conteúdo.

As chaves de projeto de IA precisam do escopo pdfhq.ai.execute e direito api.enabled; a cotação usa pdfhq.ai.quote. As sessões do navegador usam uma conta HQ protegida por CSRF.

Logo PDFHQ

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

© 2026 PDFHQ. Todos os direitos reservados.