Chat con API de PDF
Responde preguntas de PDF con evidencia vinculada a revisión y etiquetada por página usando modelos de IA aprobados y aceptación obligatoria de cotización.
Respuesta a preguntas basada en el PDF de origen#
Usar operación pdfhq.ai.chat con pregunta de hasta 2.000 caracteres, cargas verificadas y presupuesto de HQTools coincidente. El chat de PDF único requiere cantidad 1. El chat multi-documento opcional admite hasta cuatro PDF cuando se activa después de la certificación de tarifa de HQTools. Selle cada PDF primero; la cantidad de presupuesto debe ser igual al número de documentos. Todas las cargas pertenecen a la misma cuenta y proyecto de API; juntas deben totalizar como máximo 12 MiB. El trabajador clasifica fragmentos inmutables entre fuentes y rechaza ID de citas no admitidas o fabricadas.
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 multidocumento (cuando esté disponible)#
GET /v1/ai/billing/prices anuncia multi_document_available, desactivado por defecto. Para tres PDF subidos, solicita una cotización activa de chat con cantidad 3. El archivo original es el Documento 1 y additional_upload_ids corresponde a los Documentos 2 y 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 una clave de idempotencia con un conjunto de fuentes diferente devuelve 409. Las revisiones de fuentes faltantes o cambiadas, cargas entre cuentas o una cotización insuficiente se rechazan antes de la inferencia del proveedor. Las citas identifican el documento de origen y la página PDF original.
Conversaciones privadas multiturno (hasta cuatro turnos)#
Continúa un chat exitoso sin cargar los PDF nuevamente. Cada seguimiento necesita una cotización nueva, consentimiento y una clave de idempotencia nueva. Pasa previous_job_id pero omite upload_id y additional_upload_ids: el backend hereda exactamente las mismas fuentes PDF verificadas por SHA-256 propiedad de la cuenta y proyecto. Un seguimiento de múltiples documentos requiere una cotización con cantidad coincidente para todos los PDF heredados. Reutilizar la cotización anterior o cambiar documentos no es un atajo 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}Solo se pueden incluir hasta tres turnos anteriores. Las respuestas previas son contexto conversacional no confiable, no evidencia documental: las citas nuevas deben apuntar a los extractos PDF verificados actuales. Los resultados borrados o caducados y proyectos de API externos no se pueden reutilizar. Inicia un nuevo chat para cambiar los documentos de origen.
Las respuestas generadas por el modelo deben verificarse. El sistema verifica IDs de cita, no la veracidad de la inferencia. El texto faltante, escaneos deficientes y contexto recuperado limitado pueden hacer imposible una respuesta correcta.
