Logo PDFHQ

Dokumenty

DokumentacjaDokumenty i informacje wywiadowcze

Czatuj z API PDF

Odpowiadaj na pytania w formacie PDF, korzystając z zatwierdzonych modeli sztucznej inteligencji i obowiązkowej akceptacji wyceny.

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

Odpowiedź na pytanie oparta na źródłowym pliku PDF#

Użyj operacji pdfhq.ai.chat z pytaniem do 2000 znaków, zweryfikowanymi przesłanymi plikami i pasującą wyceną HQTools. Czat w jednym formacie PDF wymaga ilości 1. Opcjonalny czat wielodokumentowy obsługuje do czterech plików PDF po aktywacji po certyfikacji taryfowej HQTools. Najpierw zapieczętuj każdy plik PDF; ilość ofert musi być równa liczbie dokumentów. Wszystkie przesłane pliki należą do tego samego konta i projektu API; razem muszą mieć maksymalnie 12 MiB. Pracownik szereguje niezmienne fragmenty ze wszystkich źródeł i odrzuca nieobsługiwane lub sfabrykowane identyfikatory cytatów.

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}

Czat wielodokumentowy (jeśli jest dostępny)#

GET /v1/ai/billing/prices udostępnia multi_document_available, które domyślnie jest wyłączone. Dla trzech przesłanych PDF-ów zażądaj aktywnej wyceny czatu z ilością 3. Oryginalny plik to Dokument 1, a additional_upload_ids to Dokumenty 2 i 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}

Ponowne użycie klucza idempotencji z innym zestawem źródeł zwraca błąd 409. Brakujące lub zmienione wersje źródeł, przesyłanie między kontami lub niewystarczająca wycena są odrzucane przed wnioskowaniem przez dostawcę. Cytaty identyfikują dokument źródłowy i oryginalną stronę PDF.

Prywatne rozmowy wieloobrotowe (do czterech tur)#

Kontynuuj udaną rozmowę bez ponownego przesyłania plików PDF. Każda kontynuacja wymaga nowej wyceny, zgody i nowego klucza idempotencji. Przekaż previous_job_id, ale pomiń upload_id i additional_upload_ids: backend dziedziczy dokładnie te same źródła PDF zweryfikowane za pomocą SHA-256, należące do konta i projektu. Śledzenie wielu dokumentów wymaga wyceny dopasowanej ilościowo dla wszystkich odziedziczonych plików PDF. Ponowne wykorzystanie starej wyceny lub zmiana dokumentów nie jest dozwolonym skrótem.

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}

Można uwzględnić maksymalnie trzy poprzednie tury. Poprzednie odpowiedzi stanowią niezaufany kontekst konwersacji, a nie dowód z dokumentów: nowe cytaty muszą wskazywać na aktualnie zweryfikowane fragmenty plików PDF. Usuniętych lub wygasłych wyników oraz zagranicznych projektów API nie można ponownie wykorzystać. Rozpocznij nowy czat, aby zmienić dokumenty źródłowe.

Odpowiedzi są generowane przez model i muszą zostać sprawdzone. System weryfikuje identyfikatory cytatów, a nie prawdziwość wnioskowania. Brakujący tekst, słabe skany i ograniczony kontekst mogą uniemożliwić udzielenie prawidłowej odpowiedzi.

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.