Logo PDFHQ

Dokumen

DokumentasiDokumen & intelijen

Siklus hidup pekerjaan AI

Kutipan → verifikasi sumber → mulai pekerjaan AI asinkron → polling kutipan tervalidasi dan unduh hasil terstruktur.

Kunci API sisi server Unggahan penyimpanan yang ditandatangani

Ujung ke ujung: kutipan, cadangan, proses, selesaikan#

Operasi AI mengikuti penerimaan PDF terverifikasi yang sama dengan tugas konvensional. Harga AI HQTools yang aktif dan penawaran berskala akun untuk kuantitas 1 diperlukan. Tidak seperti alat PDF, pekerjaan AI yang dikutip diajukan ke POST /v1/ai/jobs dan berlangsung melalui buku besar terpisah yang tahan lama. PDFHQ memesan kredit HQ di worker SEBELUM menghubungi penyedia dan baru menyelesaikan pemotongan setelah hasil disimpan. Fitur ini dinonaktifkan secara bawaan hingga persyaratan peluncuran produksi diverifikasi.

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'

Status yang dapat dibaca mesin#

Pengguna faktur batch dapat membuka ruang kerja tinjauan batch faktur . Browser mengorkestrasi hingga sepuluh dikutip secara independen dan idempotentugas `pdfhq.ai.extract` dengan kredit HQ. Tidak ada diskon massal yang dibuat-buat, endpoint API berharga per batch, atau percobaan ulang otomatis saat hasil penyedia tidak pasti. Setiap baris dapat mengekspor kolom faktur terverifikasi, item rincian, dan kutipan sumber untuk pemeriksaan manusia.

Antrean → pemesanan → eksekusi → penyelesaian → berhasil. Tugas yang gagal membebaskan kredit HQ yang dipesan bila diketahui penyedia tidak berhasil menyelesaikannya. Status needs_reconciliation berarti hasil penyedia tidak pasti: JANGAN otomatis mengirim tugas baru. Mengulangi dengan kunci idempotensi yang sama akan memulihkan tugas logis yang sama. Gunakan GET /v1/ai/jobs untuk melihat daftar dan DELETE /v1/ai/jobs/{id} untuk menghapus konten terminal sambil mempertahankan tanda terima penagihan non-konten.

Kunci proyek AI memerlukan cakupan pdfhq.ai.execute dan hak pemilik api.enabled; kutipan menggunakan pdfhq.ai.quote. Sesi browser menggunakan akun HQ yang dilindungi CSRF.

Logo PDFHQ

Alat PDF dan intelijen dokumen. Siapkan, pahami, dan bekerja dengan dokumen Anda.

© 2026 PDFHQ. Semua hak dilindungi.