Logo PDFHQ

Dokumenty

DokumentacjaDokumenty i informacje wywiadowcze

Cykl życia zadania AI

Wycena → zweryfikuj źródło → rozpocznij asynchroniczne zadanie AI → przepytaj zweryfikowane cytaty i pobierz ustrukturyzowane wyniki.

Klucze API po stronie serwera Podpisane przesyłanie danych do magazynu

Od końca do końca: wycena, rezerwacja, przetwarzanie, rozliczenie#

Operacje AI podlegają temu samemu zweryfikowanemu dostępowi do plików PDF, co konwencjonalne zadania. Wymagana jest aktywna cena HQTools AI i wycena obejmująca zakres konta dla ilości 1. W przeciwieństwie do narzędzi PDF, cytowane zadanie AI jest przesyłane POST /v1/ai/jobs i przechodzi przez osobny trwały rejestr. PDFHQ rezerwuje kredyty HQ w procesie roboczym PRZED kontaktem z dostawcą i rozlicza je dopiero po zapisaniu wyniku. Funkcja jest domyślnie wyłączona do czasu weryfikacji warunków uruchomienia produkcyjnego.

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'

Stan do odczytu maszynowego#

Użytkownicy faktur zbiorczych mogą otwierać obszar roboczy przeglądu partii faktur . Przeglądarka organizuje do dziesięciu niezależnie cytowane i idempotentnezadania `pdfhq.ai.extract` rozliczane w kredytach HQ. Nie ma wymyślonych rabatów pakietowych, punktu API z ceną za pakiet ani automatycznych ponowień przy niepewnym wyniku dostawcy. Każdy wiersz może eksportować zweryfikowane pola faktury, pozycje i cytowane fragmenty źródłowe do ręcznej kontroli.

W kolejce → rezerwacja → wykonanie → rozliczenie → sukces. Nieudane zadania zwalniają rezerwację kredytów HQ, gdy wiadomo, że dostawca nie zakończył pracy pomyślnie. Stan needs_reconciliation oznacza niepewny wynik dostawcy: NIE wysyłaj automatycznie nowego zadania. Ponowienie z tym samym kluczem idempotencji przywraca to samo logiczne zadanie. Użyj GET /v1/ai/jobs, aby wyświetlić zadania, oraz DELETE /v1/ai/jobs/{id} aby usunąć zawartość terminala, zachowując jednocześnie rachunki niebędące treścią.

Klucze projektu AI wymagają zakresu pdfhq.ai.execute i uprawnienia api.enabled; cytat wykorzystuje pdfhq.ai.quote. Sesje przeglądarki korzystają z konta HQ chronionego CSRF.

Logo PDFHQ

Narzędzia PDF i inteligencja dokumentów. Przygotuj, zrozum i pracuj ze swoimi dokumentami.

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.