Logo PDFHQ

Documents

DocumentationDocuments et intelligence

Chat avec l'API PDF

Répondre aux questions PDF avec des preuves liées à la révision et étiquetées par page en utilisant des modèles d'IA approuvés et l'acceptation obligatoire des citations.

Clés API côté serveur Importations de stockage signées

Réponse aux questions fondée sur le PDF source#

Utiliser l'opération pdfhq.ai.chat avec question jusqu'à 2 000 caractères, importations vérifiées et devis HQTools correspondant. Le chat mono-PDF nécessite une quantité de 1. Le chat multi-documents optionnel supporte jusqu'à quatre PDF une fois activé après certification du tarif HQTools. Scellez d'abord chaque PDF ; la quantité du devis doit égaler le nombre de documents. Tous les fichiers importés appartiennent au même compte et au même projet API ; ensemble, ils doivent totaliser au maximum 12 Mio. Le worker classe les extraits immuables entre les sources et rejette les ID de citation non pris en charge ou fabriqués.

cURL
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-documents (si disponible)#

GET /v1/ai/billing/prices annonce multi_document_available, désactivé par défaut. Pour trois PDF téléversés, demandez un devis actif de conversation avec la quantité 3. Le téléversement d’origine est le Document 1 et additional_upload_ids représente les Documents 2 et 3.

cURL
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}

La réutilisation d'une clé d'idempotence avec un ensemble de sources différent retourne 409. Les révisions de sources manquantes ou modifiées, les importations entre comptes ou un devis insuffisant sont rejetés avant l'inférence du fournisseur. Les citations identifient le document source et la page PDF originale.

Conversations privées multi-tours (jusqu'à quatre tours)#

Poursuivez une conversation réussie sans réimporter les PDF. Chaque suivi nécessite un nouveau devis, un consentement et une nouvelle clé d'idempotence. Transmettez previous_job_id mais omettez upload_id et additional_upload_ids : le backend hérite exactement des mêmes sources PDF vérifiées par SHA-256, appartenant au compte et au projet. Un suivi multi-document nécessite un devis correspondant en quantité pour tous les PDF hérités. Réutiliser l'ancien devis ou modifier les documents n'est pas un raccourci autorisé.

cURL
# 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}

Seuls les trois tours précédents peuvent être inclus. Les réponses antérieures sont un contexte conversationnel non fiable, pas une preuve documentaire : les citations actuelles doivent pointer vers les extraits PDF vérifiés actuels. Les résultats effacés ou expirés et les projets API étrangers ne peuvent pas être réutilisés. Commencez une nouvelle conversation pour modifier les documents source.

Les réponses générées par le modèle doivent être vérifiées. Le système vérifie les ID de citation, pas la véracité de l'inférence. Le texte manquant, les mauvaises analyses et le contexte récupéré limité peuvent rendre une réponse correcte impossible.

Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.