Chat com API de PDF
Responder a perguntas de PDF com evidência vinculada a revisão, rotulada por página, utilizando modelos de IA aprovados e aceitação obrigatória de citações.
Resposta a perguntas fundamentada no PDF de origem#
Usar operação pdfhq.ai.chat com pergunta de até 2.000 caracteres, uploads verificados e cotação HQTools correspondente. Chat de PDF único requer quantidade 1. Chat multi-documento opcional suporta até quatro PDFs quando ativado após certificação de tarifa HQTools. Sele cada PDF primeiro; a quantidade de cotação deve ser igual à contagem de documentos. Todos os uploads pertencem à mesma conta e projeto de API; juntos devem totalizar no máximo 12 MiB. O worker classifica trechos imutáveis entre fontes e rejeita IDs de citação não suportados ou fabricados.
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-idempotency-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"UPLOAD_UUID","quote_id":"QUOTE_ID","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Chat multi-documento (quando disponível)#
GET /v1/ai/billing/prices indica multi_document_available, desativado por predefinição. Para três PDF carregados, peça um orçamento de chat ativo com quantidade 3. O carregamento original é o Documento 1; additional_upload_ids são os Documentos 2 e 3.
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"3"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-multi-source-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"PDF_1_UUID","additional_upload_ids":["PDF_2_UUID","PDF_3_UUID"],"quote_id":"QUOTE_WITH_QUANTITY_3","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Reutilizar uma chave de idempotência com um conjunto de origem diferente retorna 409. Revisões de origem ausentes ou alteradas, uploads entre contas ou uma cota insuficiente são rejeitados antes da inferência do provedor. Citações identificam o documento de origem e a página PDF original.
Conversas privadas com múltiplas rodadas (até quatro rodadas)#
Continue um chat bem-sucedido sem fazer upload dos PDFs novamente. Cada acompanhamento requer uma nova cotação, consentimento e uma nova chave de idempotência. Passe previous_job_id mas omita upload_id e additional_upload_ids: o backend herda exatamente as mesmas fontes PDF verificadas por SHA-256, de propriedade da conta e do projeto. Um acompanhamento multidocumento requer uma cotação com quantidade correspondente para todos os PDFs herdados. Reutilizar a cotação antiga ou alterar documentos não é um atalho permitido.
# Review cited results, then quote the NEXT turn
GET https://api.pdfhq.io/v1/ai/jobs/FIRST_CHAT_JOB_UUID/conversation
x-api-key: PROJECT_API_KEY
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"1"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: unique-follow-up-request-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","previous_job_id":"FIRST_CHAT_JOB_UUID","quote_id":"NEW_QUOTE_ID","question":"What happens if that payment is late?","allow_external_ai":true,"allow_ocr":false}Apenas até três turnos anteriores podem ser incluídos. Respostas anteriores são contexto conversacional não confiável, não evidência documental: citações novas devem apontar para os trechos PDF verificados atuais. Resultados apagados ou expirados e projetos de API estrangeiros não podem ser reutilizados. Inicie um novo chat para alterar os documentos de origem.
As respostas geradas pelo modelo devem ser verificadas. O sistema verifica IDs de citação, não a veracidade da inferência. Texto ausente, digitalizações ruins e contexto recuperado limitado podem tornar uma resposta correta impossível.
