PDFHQ logosu

Belgeler

BelgelerBelgeler ve istihbarat

Düz İngilizce PDF sayfa düzenleme API'si

Doğrulanmış bir PDF'ye karşı sınırlı, belirleyici sayfa düzenlemelerini önizleyin, tam çıktı sırasını gözden geçirin ve ayrı olarak HQTools tarafından ölçülen bir görevi onaylayın.

Sunucu tarafı API anahtarları İmzalı depolama yüklemeleri

PDF'yi faturalandırmadan veya değiştirmeden önce önizleyin#

POST /v1/documents/uploads kullanarak bir PDF yükle ve mühürle. Ardından ara POST /v1/ai/edit-plans/preview kullanıcıya ait bir upload_id ve açık bir sayfa talimatıyla. Önizleme belirlenimci komutları yorumlar; dil modeli çağırmaz veya HQ kredisi harcamaz. Desteklenen işlemler saat yönünde/tersine döndürme, silme, koruma, çoğaltma, taşıma, ters çevirme ve sayfaları yeniden sıralamadır. Bilinmeyen talimatlar tahmin edilmez, reddedilir. Özgün belgeler değişmez.

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

İsteğe bağlı ücretli, sağlayıcı tarafından oluşturulan sayfa önerileri#

Kesin belirleyici ifadelerin ötesindeki istekler için, bir operator-certified HQTools tarifi işlemi etkinleştirebilir pdfhq.ai.edit_plan. Bu varsayılan olarak devre dışıdır. AI modeli yalnızca küçük bir önerilen sayfa komutları dizisi döndürür, hiçbir zaman rastgele işleme seçenekleri veya düzenlenmiş PDF baytları döndürmez. Her komut belirleyici ayrıştırıcıdan geçmeli ve her model iddiasının alıntıları olmalıdır. Bir model önerisi belgeyi değiştirme onayı DEĞİLDİR.

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.

AI önerileri tüketir ayrı HQ kredisi ücreti. Kullanıcı daha sonra sayfa haritasını incelemeli ve değişiklikleri uygulamak için ikinci bir HQTools belge görevi fiyatı almalıdır. Yapay zekâ sonuçları onayı atlayamaz veya sayfa içeriğini yeniden yazamaz. İmzalı/form içeren PDF'ler ile değiştirilmiş veya süresi dolmuş kaynak sürümleri reddedilir.

HQTools teklifini alın ve tam planı açıkça onaylayın#

POST /v1/tasks'ı organize aracıyla oluştur, ardından aynı doğrulanmış yüklemeyi POST /v1/tasks/TASK_ID/files ile ekle. GET /v1/tasks/TASK_ID/quote, geçerli HQTools tarifesini kullanarak HQ Kredilerini tahmin eder. Müşteri sayfa listesini ve fiyatı inceledikten sonra, POST /v1/tasks/TASK_ID/process'i hem preview'deki options.pages hem de imzalı approval_token ile çağır.

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

Onay, hesap, API projesi, PDF SHA-256, yükleme kimliği, sayfa seçenekleri ve kısa süre sonunda geçerlilik için kapsamlandırılmıştır. Belgeyi veya sayfa listesini değiştirmek bu jetonu geçersiz kılar. Önizleme jetonları olmayan standart görev istemcileri çalışmaya devam eder. İmzalı PDF'ler ve form PDF'leri bu düzenleyici tarafından reddedilir. Mevcut metni yeniden yazamaz, içeriği güvenli bir şekilde gizleyemez veya kriptografik imzalar yerleştiremez.

Sayfa düzenleme inceleme arayüzünü açın →
PDFHQ logosu

PDF araçları ve belge zekası. Belgelerinizi hazırlayın, anlayın ve çalışın.

© 2026 PDFHQ. Tüm hakları saklıdır.