Logo PDFHQ

Dokumen

DokumentasiDokumen & intelijen

API pengeditan halaman PDF dalam bahasa Inggris biasa

Pratinjau pengeditan halaman yang terbatas dan deterministik terhadap PDF yang diverifikasi, tinjau urutan keluaran yang tepat, dan setujui tugas yang diukur HQTools secara terpisah.

Kunci API sisi server Unggahan penyimpanan yang ditandatangani

Pratinjau sebelum penagihan atau memodifikasi PDF#

Unggah dan segel PDF menggunakan POST /v1/documents/uploads. Kemudian panggil POST /v1/ai/edit-plans/preview dengan upload_id milik pengguna dan instruksi halaman yang jelas. Pratinjau memproses perintah deterministik; tidak memanggil model bahasa ataupun menghabiskan kredit HQ. Tindakan yang didukung adalah memutar searah atau berlawanan jarum jam, menghapus, mempertahankan, menggandakan, memindahkan, membalik, dan mengurutkan ulang halaman. Instruksi yang tidak dikenal ditolak, bukan ditebak. Dokumen asli tidak berubah.

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).

Proposal halaman opsional berbayar yang dihasilkan penyedia#

Untuk permintaan di luar frasa deterministik ketat, sebuah operator-certified Tarif HQTools dapat mengaktifkan operasi pdfhq.ai.edit_plan. Ini dinonaktifkan secara default. Model AI mengembalikan hanya larik kecil perintah halaman yang diusulkan, tidak pernah opsi pemrosesan arbitrer atau byte PDF yang diedit. Setiap perintah harus melewati pengurai deterministik dan setiap klaim model harus memiliki kutipan. Saran model BUKAN persetujuan untuk memodifikasi dokumen.

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.

Saran AI menggunakan terpisah biaya dalam kredit HQ. Pengguna kemudian harus meninjau peta halaman dan mendapatkan harga tugas dokumen HQTools kedua sebelum menerapkan perubahan. Hasil model AI tidak dapat melewati persetujuan atau menulis ulang konten halaman. PDF bertanda tangan atau berisi formulir serta revisi sumber yang berubah atau kedaluwarsa ditolak.

Dapatkan penawaran HQTools dan setujui rencana yang tepat secara eksplisit#

Buat POST /v1/tasks dengan alat organize, kemudian lampirkan unggahan terverifikasi yang sama menggunakan POST /v1/tasks/TASK_ID/files. GET /v1/tasks/TASK_ID/quote memperkirakan HQ Credits menggunakan tarif HQTools saat ini. Hanya setelah pelanggan meninjau daftar halaman dan harga, panggil POST /v1/tasks/TASK_ID/process dengan options.pages dari pratinjau dan approval_token yang ditandatangani.

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

Persetujuan dibatasi pada akun, proyek API, SHA-256 PDF, ID unggahan, opsi halaman, dan kedaluwarsa singkat. Mengubah dokumen atau daftar halaman membatalkan token ini. Klien tugas standar tanpa token pratinjau terus berfungsi. PDF yang ditandatangani dan PDF formulir ditolak oleh editor ini. Tidak dapat menulis ulang teks yang ada, menyembunyikan konten dengan aman, atau menempatkan tanda tangan kriptografi.

Buka antarmuka tinjauan edit halaman →
Logo PDFHQ

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

© 2026 PDFHQ. Semua hak dilindungi.