v2026.05 · JSON’dan PDF üretim API’si

Dünyanın en hızlı API'si yüksek hacimli faturalar ve etiketler için

5 $ karşılığında 100.000 sayfa. PDF’ler edge’de birkaç milisaniyede oluşturulur

Küresel ölçek için tasarlandı PDF/A, Factur-X ve ZUGFeRD zorunluluklarıyla tam uyumlu

Canlı API'yi dene API referansını gör kredi kartı yok · kurulum yok · curl dostu
CPU / render (p50)
4.98ms · 24h
Sunulan istek
299/ 24h
Maliyet
$5 / 100K
Bölgeler
300+ pops
30+ barkod formatı 4 PDF/A profili 100K sayfa $5/ay'dan
Playground

JSON gönder. PDF oluştur.
Temel özellikler, hepsi tek sayfada.

Solda DocumentRequest’i düzenleyin. Canlı edge worker’ı çağırın
gerçek schema, gerçek PDF, genelde <5 ms.

Neden gPdf

gPdf dört temel sütun üzerine inşa edilmiştir.

01 / 04
$5
per 100K pages

Maliyet

Cloudflare Workers üzerinde çalışır — saatte $0,40 ücretlendirilen 800 MB Chromium konteynerinin boş beklemesine gerek yok. Sayfa başına $0,00005. Minimum yok, koltuk başı ücret yok, ortam başı ek ücret yok.

02 / 04
PDF/A
1b · 2b · 3b · 4

Standartlar

PDF/A arşiv profilleri (1b, 2b, 3b, 4) talep üzerine. Factur-X, ZUGFeRD ve EN 16931 native olarak destekleniyor — API referansının 5. Bölümü, yol haritası bağlantısı değil.

03 / 04
JSON → PDF
API + editor, one schema

JSON-native

pages[], elements[], x/y milimetre cinsinden. HTML→PDF yok, headless Chrome yok, öğrenilecek template DSL yok. Aynı JSON hem API'yi hem görsel editörü besler — tasarımcılar ve geliştiriciler tek dosyayı düzenler.

04 / 04
3000+
color emoji, embedded

Tipografi

Latin, CJK, Arapça (RTL + karmaşık shaping), Devanagari, Kiril, Bengalce ve Tay alfabesi motorda gömülü — artı 3000+ renkli emoji. `apt install fonts-noto-cjk` yok. Asla eksik bir glif yok.

Özellikler

Temel ama kritik ayrıntılar, doğru yapılmış.

Bir PDF wrapper'ında tarayıcı ekran görüntüleri değil, gerçek belge semantiği.

Browse use cases
/01

Piksel düzeyinde kontrol

x/y milimetre cinsinden, sağ kenar hizalama için x_anchor, etiketlerde sub-milimetre yerleşim. Koordinatlar, yaklaşıklıklar değil.

// inside elements[i]
"x_anchor": {
  "reference": "content_right",
  "offset": 6
}
/02

Vektör barkodlar

GS1-128, QR, PDF417, DataMatrix dahil 30+ semboloji. Hepsi vektör. Toplam uzunluk 0,1 mm'ye doğru.

// 30+ formats: code128, qrcode, datamatrix, pdf417, ...
"type": "barcode",
"format": "code128",
"content": "INV-2026-001"
Why vector beats raster
/03

Yazı tipi yedek zinciri

font_mode: strict (bildirilen aile tüm glifleri kapsamalı), prefer (gömülü ailelere geri düş), auto (motor seçer). auto/prefer tükenirse API-504 döner — sessiz değil, açık başarısızlık.

// inside style{}
"font_family": "NotoSans-Regular",
"font_mode": "prefer"
/04

Uyumluluk modları

settings.profile = "pdfa-3b" hem PDF/A-3b uyumluluğunu hem de Factur-X / ZUGFeRD'nin gerektirdiği gömülü XML ek akışını tetikler. Tek alan, tek uyumlu belge.

// top-level on DocumentRequest
"settings": {
  "profile": "pdfa-3b"
}
PDF/A and Factur-X, explained
/05

Değişkenler + sayfalama

{page} / {total_pages} layout sonrası çözülür. keep_together, widow/orphan, page_break blokları.

// element of type "variable"
{ "type": "variable",
  "name": "page",
  "scope": "system" }
/06

Sayfalanan tablolar

Sayfalar arası row_span, tekrarlanan başlıklar, alternate_fill, kompozit çift kenarlıklar. Her zaman bozulan %1.

// inside table element
"pagination": {
  "keep_spans_together": true
}
/07

Tek JSON, iki yüzey

Aynı DocumentRequest JSON'u hem POST /api/v1/pdf/render'i hem de editor.gpdf.com'daki görsel editörü çalıştırır. Görsel düzenle, API ile gönder veya elle yaz — üç yol da aynı dosyada round-trip yapar.

// three routes, one engine
POST /api/v1/pdf/render
POST /api/v1/template-render
POST /api/v1/e-invoice/render
Read the API reference
/08

Faturalar için inşa edildi

Sayfa başına $0,00005, p50 3 ms, gömülü CJK, PDF/A-3 ek akışı. Fintech, ERP ve vergi uyumluluk ekiplerinin önce kontrol ettiği dört sayı.

// invoice — header + table pattern
{ "size": "a4",
  "elements": [
    { "type": "text",  "x": 18, "y": 22, ... },
    { "type": "table", "x": 18, "y": 60, ... }
  ]}
Why JSON beats HTML→PDF
/09

Kargo etiketleri için inşa edildi

label_100_150 ve label_4_6_in boyut presetleri. 0,1 mm hassasiyetinde vektör GS1-128, ITF-14, SSCC — taşıyıcılar ve 3PL'ler yoğun dönemde raster barkod olmadan yazdırır.

// 4×6 thermal shipping label
{ "size": "label_4_6_in",
  "elements": [{
    "type": "barcode",
    "format": "code128",
    "content": "1Z999AA10123456784" }]}
Shipping-label use case
Benchmark · sampled 2026-04-29

Ölçüldü, pazarlanmadı.

1 sayfalık A4 fatura, 12 satır öğesi, QR + logo. 1000 PDF üretiminin medyanı. Daha düşük daha iyi.

Methodology: 1-page A4 invoice · 12 line items · 1 QR + 1 logo · 1K invocations · median (p50) and p99 reported. Sampled 2026-04-29 from a workstation in EU-WEST. PDFShift, DocRaptor, Puppeteer and LaTeX numbers are reproduced from each vendor's published quickstart sample with the same input — re-run on your own workload before deciding. Read the head-to-head comparisons →

0 105ms 210ms 315ms 420ms
01 gPdf ours
3.8ms
02 PDFShift
95ms
03 DocRaptor (Prince)
180ms
04 Puppeteer (headless)
312ms
05 LaTeX (local)
420ms
Fiyatlar

Sayfalar için ödeyin. Başka bir şey için değil.

Per-seat yok. Per-environment yok. Destek katmanı gatekeeping yok.

Tüm ücretli katmanlar aynı 100.000 sayfayı ve aynı render limitlerini içerir. Sadece metadata özelleştirme, PDF/A profil kullanılabilirliği ve aşım oranında farklılık gösterirler.

Free Trial

/free
$0 sonsuza kadar

Günde 100 sayfa · kotada durur.

  • +Günde 100 sayfa · otomatik reset
  • +Playground + API değerlendirme
  • +Kart gerekmez
  • +E-posta desteği · 1 iş günü SLA
Playground'u dene

Basic

/basic
$5 / ay

Aylık 100.000 sayfa dahil.

  • +Aylık 100.000 sayfa dahil
  • +Aşım sayfa başına $0.00005
  • +Standart PDF metadata · özelleştirilemez
  • +Sadece standart PDF · PDF/A profili yok
  • +E-posta desteği · 1 iş günü SLA
Abone ol

Pro

/pro
$8 / ay

Aylık 100.000 sayfa dahil. Özelleştirilebilir metadata.

  • +Aylık 100.000 sayfa dahil
  • +Aşım sayfa başına $0.00008
  • +Başlık · konu · oluşturucu özelleştirilebilir
  • +Sadece standart PDF · PDF/A profili yok
  • +E-posta desteği · 1 iş günü SLA
Abone ol

Enterprise

/ent
$12 / ay

Aylık 100.000 sayfa dahil. PDF/A + tam metadata.

  • +Aylık 100.000 sayfa dahil
  • +Aşım sayfa başına $0.00012
  • +6 metadata alanının tamamı tamamen özelleştirilebilir
  • +PDF/A-1b · 2b · 3b · 4 etkin
  • +E-posta desteği · 1 iş günü SLA
Abone ol
Özel deploy

gPdf'i kendi güvenlik sınırlarınız içinde çalıştırmanız mı gerekiyor?

Regüle ekipler, özel cloud/VPC deploy'ları ve izole intranet ortamları için. gPdf'i adanmış Worker, server veya gateway destekli deployment olarak çalıştırın; ağ kontrolleri, bölge gereksinimleri, DPA şartları ve destek eskalasyonu her proje için belirlenir.

  • +Özel cloud, VPC veya izole ağ
  • +Adanmış Worker/server deployment
  • +DPA şartları ve veri yerleşimi kontrolleri
  • +Destek modeli baştan netleştirilir
Özel deploy için iletişim · soon
FAQ

Geliştiricilerin gerçekten sorduğu sorular.

On iki yanıt — Google rich results'ın tükettiği JSON-LD FAQPage tarafından kelimesi kelimesine alıntılanır.

/01

gPdf bir PDF'i ne kadar hızlı render eder?

1000 çağrı üzerinde tek bir A4 sayfada p50 3 ms ve p99 8 ms'dir. Ağ dahil toplam edge wall time tipik olarak 8-15 ms'dir.

/02

API hangi giriş formatını kabul eder?

JSON DocumentRequest gövdesi. Sayfalar, elemanlar, katmanlar, filigranlar, başlıklar, altbilgiler ve tablolar yapısal olarak ifade edilir — HTML yok, Markdown yok, tarayıcı layout pass'i yok.

/03

gPdf, Puppeteer veya headless Chrome ile nasıl karşılaştırılır?

Headless Chromium render başına 200-800 ms çalışır ve 800 MB konteyner gerektirir. gPdf aynı A4 sayfayı 1 MB V8 isolate içinde 3 ms'de render eder, cold start yok. Trade-off giriş formatıdır: gPdf JSON DocumentRequest alır, ham HTML almaz.

/04

gPdf API endpoint'leri nelerdir?

Üç: /api/v1/pdf/render piksel düzeyinde kontrol için tam DocumentRequest alır. /api/v1/template-render template_id artı veri dizisi alır. /api/v1/e-invoice/render Factur-X / ZUGFeRD hibrit faturalar (PDF/A-3 + gömülü XML) üretir. Üçü de aynı engine, aynı rate limit ve aynı hata kodu yüzeyini paylaşır.

/05

Çince, Japonca veya Korece için sunucuma font yüklemem gerekiyor mu?

Hayır. NotoSans CJK gömülüdür ve otomatik font fallback zinciri eksik glifleri ele alır. Asla tofu kutusu görmeyecek ve runtime'ınızda apt install fonts-noto-cjk'ye ihtiyaç duymayacaksınız.

/06

Hangi barkodları render edebilirim?

QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode ve Code 128 dahil 30'dan fazla semboloji. Hepsi vektör. Toplam barkod uzunluğu istenen boyutun 0,1 mm'si içinde — GS1 ve ITF-14 tarafından belirtilen etiket genişlikleri için yeterince hassas.

/07

gPdf, PDF/A veya e-fatura uyumlu çıktı üretir mi?

Evet. PDF/A-1b, 2b, 3b ve 4 istek başına seçilebilir. Factur-X ve ZUGFeRD ek akışları e-fatura senaryoları için desteklenir.

/08

gPdf, Factur-X, ZUGFeRD veya EN 16931 e-faturaları üretebilir mi?

Evet. settings.profile'ı pdfa-3b olarak ayarlayın ve yapılandırılmış XML payload'ı dosya akışı olarak ekleyin. Factur-X ve ZUGFeRD PDF/A-3 üzerinde çalışır — yürürlükteki Alman e-fatura mandatı ve Eylül 2026'dan itibaren Fransız B2B mandatı için gerekli.

/09

gPdf gerçekten nerede çalışıyor?

Cloudflare Workers V8 isolate'leri içinde. Chromium konteyneri yok, Lambda warming yok, istek sonrası belge persistance'ı yok.

/10

gPdf, PDF'lerimi veya giriş verilerimi saklar mı?

Hayır. Renderer stateless'tır. DocumentRequest'iniz V8 isolate'te render'ın birkaç milisaniyesi boyunca yaşar, sonra kaybolur. gPdf'in caching katmanı veya belge deposu yok — statelessness sözleşmedir, opt-in toggle değil.

/11

Ücretsiz katman var mı?

Evet. Free Trial günde 100 sayfa verir, kredi kartı gerekmez. Günlük otomatik resetlenir ve kotada durur — sürpriz fatura yok. Ücretli katmanlar 100.000 sayfa için aylık $5'dan başlar.

/12

gPdf'i kullanmaya nasıl başlarım?

Yukarıdaki playground'u açın, DocumentRequest’i düzenleyin ve PDF oluştur’a basın — canlı edge worker gerçek bir PDF döndürür. Curl snippet'ini terminalinize kopyalayın, her yerden çağırın. Playground kurulum veya kredi kartı gerektirmez; sadece kendi API key'inizi vermek için bir hesap gereklidir.

Blog'dan

Taze mühendislik denemeleri.

Tüm yazıları görüntüle
  1. 2026'da PDF API seçmek: sormanız gereken 8 soru

    PDF üretim API'si seçmek için satıcıdan bağımsız bir karar çerçevesi. 12 ay sonra memnun kalıp kalmayacağınızı gösteren sekiz soru.

  2. gPdf vs DocRaptor: edge rendering neden HTML-to-PDF'i yener

    DocRaptor, HTML'i PDF'e çevirmek için hosted backend'de Prince kullanır. gPdf structured JSON'u doğrudan Cloudflare edge'de render eder. Fiyat farkı 18× ve bu teaser değildir.

  3. Mühendisler için PDF/A ve Factur-X, hukuki dil olmadan

    PDF/A profillerinin gerçekte neyi kısıtladığı, Factur-X'in Avrupa e-faturası için neden önemli olduğu ve JSON renderer'dan uyumlu PDF üretmenin en küçük pratik pipeline'ı.

Güven

Uyumluluk ve veri ikametgâhı

Auditlanabilir mühendislik artı evrak işi — her iki kayıt da doğrulanabilir.

SOC2

SOC 2 Type II

Audit Q3 2026 için planlandı · kanıt talep üzerine.

GDPR

GDPR + DPA

Standart sözleşme maddeleri talep üzerine mevcut.

REGION

Veri ikametgâhı

EU, US, APAC ve SA veri yerleşimi seçenekleri. Bölge gereksinimleri sözleşmede netleştirilir.

STATELESS

Varsayılan olarak stateless

Belge persistence yok. Üründe cache katmanı veya belge deposu yok.

BENCHED

Kamuya açık benchmark'lar

Adlandırılmış rakipler, tam metodoloji, örneklem tarihi. Bu sayfadaki her benchmark tekrarlanabilir — karar vermeden önce kendi yükünüzde yeniden çalıştırın.

DETERMINISTIC

Deterministik

Aynı input → bayt-aynı PDF. Diff'lenebilir. Snapshot drift olmadan CI'da test edilebilir.