Logo PDFHQ

Dokumenty

DokumentacjaDokumenty i informacje wywiadowcze

Zwykły interfejs API do edycji stron PDF w języku angielskim

Wyświetl podgląd ograniczonych, deterministycznych zmian strony w zweryfikowanym pliku PDF, przejrzyj dokładną sekwencję wyjściową i zatwierdź oddzielnie mierzone zadanie HQTools.

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

Podgląd przed rozliczeniem lub modyfikacją pliku PDF#

Prześlij i zapieczętuj plik PDF za pomocą POST /v1/documents/uploads. Następnie zadzwoń POST /v1/ai/edit-plans/preview z należącym do użytkownika upload_id i jednoznacznym poleceniem dotyczącym strony. Podgląd interpretuje deterministyczne polecenia; nie wywołuje modelu językowego i nie zużywa kredytów HQ. Dostępne działania to obrót w obu kierunkach, usunięcie, zachowanie, powielenie, przeniesienie, odwrócenie i zmiana kolejności stron. Nieznane polecenia są odrzucane zamiast zgadywane. Oryginały pozostają bez zmian.

cURL
POST https://api.pdfhq.io/v1/ai/edit-plans/preview
x-api-key: PROJECT_API_KEY
Content-Type: application/json

{"upload_id":"SEALED_UPLOAD_UUID","instruction":"Delete page 3; rotate page 1 clockwise"}

# Response includes tool="organize", options.pages, exact input/output page mapping,
# source_revision, approval_token and approval_expires_at (15 minutes).

Opcjonalne płatne propozycje stron generowane przez dostawcę#

W przypadku żądań wykraczających poza ściśle deterministyczne sformułowanie, an operator-certified Taryfa HQTools może umożliwić działanie pdfhq.ai.edit_plan. Opcja ta jest domyślnie wyłączona. Model AI zwraca tylko niewielką tablicę proponowanych poleceń strony, nigdy nie arbitralne opcje przetwarzania lub edytowane bajty PDF. Każde polecenie musi przejść przez deterministyczny analizator składni, a każde żądanie modelu musi mieć cytaty. Sugestia dotycząca modelu NIE oznacza zgody na modyfikację dokumentu.

cURL
# Discover only activated HQTools tariffs for pdfhq.ai.edit_plan
GET https://api.pdfhq.io/v1/ai/billing/prices
POST https://api.pdfhq.io/v1/ai/billing/quotes
{"price_id":"CERTIFIED_AI_EDIT_PLAN_PRICE_ID","quantity":"1"}

# Only AFTER explicit approval of the HQ-credit quote and excerpt sharing:
POST https://api.pdfhq.io/v1/ai/jobs
Idempotency-Key: STABLE_RANDOM_IDEMPOTENCY_KEY
{"operation":"pdfhq.ai.edit_plan","upload_id":"SEALED_UPLOAD_UUID",
 "quote_id":"AI_QUOTE_ID","question":"Rotate the appendix page clockwise",
 "allow_external_ai":true,"allow_ocr":false}

GET https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID
# Upon success, validate the proposed commands against the ORIGINAL sealed PDF:
POST https://api.pdfhq.io/v1/ai/edit-plans/from-job
{"job_id":"AI_JOB_UUID"}
# Returns exact page map and 15-minute user-review token, NOT a paid editing job.

Sugestie AI zużywają a oddzielne opłatę w kredytach HQ. Użytkownik musi następnie sprawdzić układ stron i uzyskać drugą wycenę zadania dokumentowego HQTools, aby zastosować zmiany. Wyniki AI nie mogą omijać zatwierdzenia ani przepisywać treści stron. Podpisane PDF-y, formularze oraz zmienione lub wygasłe wersje źródłowe są odrzucane.

Uzyskaj wycenę HQTools i wyraźnie zatwierdź dokładny plan#

Utwórz POST /v1/tasks za pomocą narzędzia Organizuj, a następnie dołącz ten sam zweryfikowany plik za pomocą POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote szacuje kredyty HQ przy użyciu aktualnej taryfy HQTools. Dopiero gdy klient przejrzy listę stron i cenę, wywołaj POST /v1/tasks/TASK_ID/process z obiema opcjami.stron z podglądu i jego podpisem approval_token.

cURL
POST https://api.pdfhq.io/v1/tasks
{"tool":"organize"}

POST https://api.pdfhq.io/v1/tasks/TASK_ID/files
{"upload_id":"SEALED_UPLOAD_UUID"}

GET https://api.pdfhq.io/v1/tasks/TASK_ID/quote

POST https://api.pdfhq.io/v1/tasks/TASK_ID/process
{"options":{"pages":[{"source":1,"rotation":90},{"source":2,"rotation":0}]},
 "approval_token":"SIGNED_PREVIEW_APPROVAL"}

GET https://api.pdfhq.io/v1/tasks/TASK_ID
GET https://api.pdfhq.io/v1/tasks/TASK_ID/download-url

Zatwierdzenie obejmuje konto, projekt API, plik PDF SHA-256, identyfikator przesyłania, opcje strony i krótki okres ważności. Zmiana dokumentu lub listy stron unieważnia ten token. Klienci zadań standardowych bez tokenów podglądu nadal działają. Podpisane pliki PDF i formularze PDF są odrzucane przez ten edytor. Nie może przepisać istniejącego tekstu, bezpiecznie ukryć treści ani umieścić podpisów kryptograficznych.

Otwórz interfejs recenzji edycji strony →
Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.