Logo PDFHQ

Documents

DocumentationDocuments et intelligence

Cycle de vie des tâches IA

Devis → vérifier la source → démarrer une tâche IA asynchrone → interroger les citations validées et télécharger les résultats structurés.

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

De bout en bout : devis, réservation, traitement, règlement#

Les opérations IA suivent la même admission PDF vérifiée que les tâches conventionnelles. Un prix IA HQTools actif et un devis limité au compte pour la quantité 1 sont requis. Contrairement aux outils PDF, une tâche IA devisée est soumise à POST /v1/ai/jobs et progresse dans un registre durable distinct. PDFHQ réserve les crédits HQ dans le worker AVANT de contacter le fournisseur et ne procède au règlement qu’après stockage du résultat. Cette fonction est désactivée par défaut jusqu’à vérification des conditions de lancement en production.

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'

Statut lisible par machine#

Les utilisateurs de factures en lot peuvent ouvrir l'espace de travail d'examen des lots de factures . Le navigateur orchestre jusqu'à dix indépendamment cotés et idempotentsdes tâches `pdfhq.ai.extract` payées en crédits HQ. Il n’existe ni remise de lot inventée, ni point d’accès API facturé au lot, ni nouvelle tentative automatique lorsque le résultat du fournisseur est incertain. Chaque ligne permet d’exporter les champs de facture vérifiés, les lignes de détail et les extraits sources cités pour examen humain.

En attente → réservation → exécution → règlement → réussite. Les tâches échouées libèrent leur réservation de crédits HQ lorsque l’on sait que le fournisseur n’a pas terminé. L’état needs_reconciliation signifie que le résultat du fournisseur est incertain : NE soumettez PAS automatiquement une nouvelle tâche. Une nouvelle tentative avec la même clé d’idempotence retrouve la même tâche logique. Utilisez GET /v1/ai/jobs pour lister les tâches et DELETE /v1/ai/jobs/{id} pour effacer le contenu du terminal tout en conservant les reçus de facturation non-contenu.

Les clés de projet IA nécessitent la portée pdfhq.ai.execute et l'habilitation api.enabled ; la cotation utilise pdfhq.ai.quote. Les sessions de navigateur utilisent un compte HQ protégé par CSRF.

Logo PDFHQ

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

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