v2026.05 · API zur PDF-Erzeugung aus JSON

Die weltweit schnellste API für Rechnungen und Etiketten in hohen Stückzahlen

100.000 Seiten für 5 $. PDFs am Edge in wenigen Millisekunden erzeugt

Gebaut für globale Skalierung Vollständig konform mit PDF/A, Factur-X und ZUGFeRD

Live-API ausprobieren API-Referenz ansehen keine Kreditkarte · keine Installation · curl-freundlich
CPU / Render (p50)
4.98ms · 24h
Bediente Requests
299/ 24h
Kosten
$5 / 100K
Regionen
300+ pops
30+ Barcode-Formate 4 PDF/A-Profile 100K Seiten ab $5/Monat
Playground

JSON per POST senden. PDF erzeugen.
Kernfunktionen, alle auf einer Seite.

Bearbeite links den DocumentRequest. Rufe den Live-Edge-Worker auf
echtes Schema, echtes PDF, typischerweise <5 ms.

Warum gPdf

gPdf ruht auf vier Säulen.

01 / 04
$5
per 100K pages

Kosten

Läuft auf Cloudflare Workers — kein 800-MB-Chromium-Container, der bei 0,40 $/Stunde im Leerlauf wartet. Pro Seite 0,00005 $. Keine Mindestpreise, keine Seat-Lizenzen, keine Umgebungs-Aufschläge.

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

Standards

PDF/A-Archivprofile (1b, 2b, 3b, 4) auf Anfrage. Factur-X, ZUGFeRD und EN 16931 als native E-Invoice-Payloads — Abschnitt 5 der API-Referenz, nicht ein Roadmap-Eintrag.

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

JSON-nativ

pages[], elements[], x/y in Millimetern. Kein HTML→PDF, kein Headless Chrome, keine Template-DSL zum Erlernen. Dasselbe JSON speist die API und den visuellen Editor — Designer und Entwickler bearbeiten dieselbe Datei.

04 / 04
3000+
color emoji, embedded

Typografie

Latin, CJK, Arabisch (RTL + komplexes Shaping), Devanagari, Kyrillisch, Bengali und Thai sind in der Engine enthalten — plus 3000+ Farb-Emojis. Kein `apt install fonts-noto-cjk`. Nie ein fehlendes Zeichen.

Funktionen

Die grundlegenden Details, richtig umgesetzt.

Echte Dokumentensemantik, keine Browser-Screenshots in einem PDF-Wrapper.

Browse use cases
/01

Pixelgenaue Kontrolle

x/y in Millimetern, x_anchor für rechtsbündige Ausrichtung, sub-millimeter-genaue Platzierung auf Etiketten. Koordinaten, keine Näherungen.

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

Vektor-Barcodes

30+ Symbologien inkl. GS1-128, QR, PDF417, DataMatrix. Alle vektorbasiert. Gesamtlänge auf 0,1 mm genau.

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

Font-Fallback-Kette

font_mode: strict (deklarierte Familie muss alle Glyphen abdecken), prefer (Fallback durch gebündelte Familien), auto (Engine wählt). Erschöpfung in auto/prefer liefert API-504 — fail-loud, nicht still.

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

Compliance-Modi

settings.profile = "pdfa-3b" aktiviert PDF/A-3b-Konformität plus den eingebetteten XML-Anhangsstrom, den Factur-X / ZUGFeRD verlangen. Ein Feld, ein konformes Dokument.

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

Variablen + Paginierung

{page} / {total_pages} nach dem Layout aufgelöst. keep_together, widow/orphan, page_break-Blöcke.

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

Tabellen, die paginieren

row_span über Seiten hinweg, wiederholte Header, alternate_fill, zusammengesetzte doppelte Ränder. Das 1 %, das immer kaputtgeht.

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

Ein JSON, zwei Oberflächen

Dasselbe DocumentRequest-JSON treibt POST /api/v1/pdf/render und den visuellen Editor unter editor.gpdf.com. Visuell editieren, per API ausliefern oder von Hand schreiben — alle drei Wege roundtrippen dieselbe Datei.

// 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

Gebaut für Rechnungen

$0,00005 pro Seite, p50 3 ms, eingebettetes CJK, PDF/A-3-Anhang-Stream. Die vier Zahlen, die Fintech-, ERP- und Steuer-Compliance-Teams zuerst prüfen.

// 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

Gebaut für Versandetiketten

label_100_150- und label_4_6_in-Größen-Presets. Vektor-GS1-128, ITF-14, SSCC mit 0,1 mm Präzision — Carrier und 3PLs drucken im Hochlauf ohne rasterisierte Barcodes.

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

Gemessen, nicht beworben.

1-seitige A4-Rechnung, 12 Positionen, QR + Logo. Median aus 1000 PDF-Erzeugungen. Niedriger ist besser.

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
Preise

Bezahle für Seiten. Sonst nichts.

Kein Per-Seat. Kein Per-Environment. Kein Support-Tier-Gatekeeping.

Alle Bezahltarife enthalten dieselben 100.000 Seiten und dieselben Render-Limits. Sie unterscheiden sich nur in Metadaten-Anpassung, PDF/A-Profil-Verfügbarkeit und Mehrverbrauchs-Tarif.

Kostenlose Testversion

/free
$0 für immer

100 Seiten / Tag · stoppt am Kontingent.

  • +100 Seiten / Tag · automatischer Reset
  • +Playground + API-Evaluation
  • +Keine Kreditkarte erforderlich
  • +E-Mail-Support · 1 Werktag SLA
Playground ausprobieren

Basic

/basic
$5 / Monat

100.000 Seiten / Monat enthalten.

  • +100.000 Seiten / Monat enthalten
  • +Mehrverbrauch $0.00005 pro Seite
  • +Standard-PDF-Metadaten · nicht anpassbar
  • +Nur Standard-PDF · keine PDF/A-Profile
  • +E-Mail-Support · 1 Werktag SLA
Abonnieren

Pro

/pro
$8 / Monat

100.000 Seiten / Monat enthalten. Anpassbare Metadaten.

  • +100.000 Seiten / Monat enthalten
  • +Mehrverbrauch $0.00008 pro Seite
  • +Anpassbarer Titel · Betreff · Ersteller
  • +Nur Standard-PDF · keine PDF/A-Profile
  • +E-Mail-Support · 1 Werktag SLA
Abonnieren

Enterprise

/ent
$12 / Monat

100.000 Seiten / Monat enthalten. PDF/A + volle Metadaten.

  • +100.000 Seiten / Monat enthalten
  • +Mehrverbrauch $0.00012 pro Seite
  • +Alle 6 Metadatenfelder voll anpassbar
  • +PDF/A-1b · 2b · 3b · 4 aktiviert
  • +E-Mail-Support · 1 Werktag SLA
Abonnieren
Private Bereitstellung

Muss gPdf innerhalb deines eigenen Perimeters laufen?

Für regulierte Teams, Private-Cloud-/VPC-Deployments und isolierte Intranet-Umgebungen. gPdf läuft als dedizierter Worker, Server oder Gateway-gestützte Bereitstellung; Netzwerkkontrollen, Regionsanforderungen, DPA-Bedingungen und Support-Eskalation werden pro Projekt festgelegt.

  • +Private Cloud, VPC oder isoliertes Netzwerk
  • +Dedizierte Worker-/Server-Bereitstellung
  • +DPA-Bedingungen und Datenresidenz-Kontrollen
  • +Supportmodell vorab festgelegt
Kontakt für private Bereitstellung · soon
FAQ

Fragen, die Entwickler wirklich stellen.

Zwölf Antworten — wörtlich zitiert vom JSON-LD FAQPage, das Google Rich Results konsumiert.

/01

Wie schnell rendert gPdf ein PDF?

p50 liegt bei 3 ms, p99 bei 8 ms — gemessen über 1000 Aufrufe für eine einzelne A4-Seite. Die gesamte Edge-Wandzeit inkl. Netzwerk beträgt typischerweise 8 bis 15 ms.

/02

Welches Eingabeformat akzeptiert die API?

Einen JSON-DocumentRequest-Body. Seiten, Elemente, Layer, Wasserzeichen, Header, Footer und Tabellen werden alle strukturell ausgedrückt — kein HTML, kein Markdown, kein Browser-Layout-Pass.

/03

Wie schneidet gPdf gegenüber Puppeteer oder headless Chrome ab?

Headless Chromium läuft mit 200 bis 800 ms pro Rendering und braucht einen 800-MB-Container. gPdf rendert dieselbe A4-Seite in 3 ms innerhalb eines 1 MB großen V8-Isolates — ohne Cold Start. Der Trade-off ist das Eingabeformat: gPdf nimmt einen JSON-DocumentRequest, kein rohes HTML.

/04

Was sind die gPdf-API-Endpoints?

Drei: /api/v1/pdf/render nimmt einen vollständigen DocumentRequest für pixelgenaue Kontrolle. /api/v1/template-render nimmt template_id plus ein Daten-Array für Systeme mit veröffentlichtem Template. /api/v1/e-invoice/render erzeugt Factur-X / ZUGFeRD-Hybrid-Rechnungen (PDF/A-3 + eingebettetes XML). Alle drei teilen dieselbe Engine, dieselben Rate Limits und dieselbe Fehlercode-Oberfläche.

/05

Muss ich auf meinem Server Schriften für Chinesisch, Japanisch oder Koreanisch installieren?

Nein. NotoSans CJK ist eingebettet, eine automatische Schrift-Fallback-Kette behandelt fehlende Glyphen. Du wirst nie Tofu-Boxen sehen und brauchst auf deiner Runtime kein apt install fonts-noto-cjk.

/06

Welche Barcodes kann ich rendern?

Über 30 Symbologien inklusive QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode und Code 128. Alle vektorbasiert. Die Gesamtlänge des Barcodes liegt innerhalb von 0,1 mm der angeforderten Größe — präzise genug für GS1- und ITF-14-spezifizierte Etikettenbreiten.

/07

Erzeugt gPdf PDF/A oder konforme E-Rechnung-Ausgaben?

Ja. PDF/A-1b, 2b, 3b und 4 sind pro Request wählbar. Factur-X- und ZUGFeRD-Anhang-Streams werden für E-Rechnungs-Szenarien unterstützt.

/08

Kann gPdf Factur-X-, ZUGFeRD- oder EN 16931-E-Rechnungen erzeugen?

Ja. Setze settings.profile auf pdfa-3b und hänge den strukturierten XML-Payload als Datei-Stream an. Factur-X und ZUGFeRD basieren auf PDF/A-3 — erforderlich für das in Deutschland bereits geltende E-Rechnungs-Mandat und das französische B2B-Mandat ab September 2026.

/09

Wo läuft gPdf eigentlich?

In Cloudflare Workers V8-Isolates. Es gibt keinen Chromium-Container, keine Lambda-Aufwärmung und keine Dokumenten-Persistenz nach dem Request.

/10

Speichert gPdf meine PDFs oder Eingabedaten?

Nein. Der Renderer ist zustandslos. Dein DocumentRequest lebt im V8-Isolate für die wenigen Millisekunden des Renderings, dann ist er weg. gPdf hat keine Caching-Schicht und keinen Document Store — Statelessness ist der Vertrag, kein Opt-in-Toggle.

/11

Gibt es eine kostenlose Stufe?

Ja. Die kostenlose Testversion bietet 100 Seiten pro Tag, ohne Kreditkarte. Sie setzt sich täglich zurück und stoppt am Kontingent — keine Überraschungsrechnung. Bezahltarife beginnen bei $5 pro Monat für 100.000 Seiten.

/12

Wie fange ich an, gPdf zu nutzen?

Öffne den Playground oben, bearbeite den DocumentRequest und klicke auf PDF erzeugen — der Live-Edge-Worker liefert ein echtes PDF zurück. Kopiere das curl-Snippet in dein Terminal, um es von überall aufzurufen. Der Playground erfordert keine Installation und keine Kreditkarte; ein Konto wird nur benötigt, um deinen eigenen API-Key auszustellen.

Aus dem Blog

Engineering-Essays, frisch.

Alle Beiträge ansehen
  1. Eine PDF-API 2026 auswählen: 8 Fragen, die Sie stellen sollten

    Ein herstellerneutrales Entscheidungsmodell für PDF-Generierungs-APIs. Acht Fragen, die zeigen, ob Sie in 12 Monaten noch zufrieden sind.

  2. gPdf vs DocRaptor: Warum Edge-Rendering HTML-zu-PDF schlägt

    DocRaptor verwendet Prince, um HTML auf einem gehosteten Backend in PDF umzuwandeln. gPdf rendert strukturiertes JSON direkt am Cloudflare Edge. Die Preislücke beträgt 18×. Hier ist, warum das kein Lockangebot ist.

  3. PDF/A und ZUGFeRD für Entwickler erklärt (ohne Juristen-Sprache)

    Was PDF/A-Profile wirklich einschränken, warum ZUGFeRD und Factur-X EU-weit ab 2025-2027 vorgeschrieben werden, und die kleinste praktische Pipeline für konforme E-Rechnung aus einem JSON-Renderer.

Vertrauen

Compliance & Datenresidenz

Auditfähiges Engineering plus die Papierform — beide Register, beide verifizierbar.

SOC2

SOC 2 Type II

Audit für Q3 2026 geplant · Nachweis auf Anfrage.

GDPR

DSGVO + AVV

Standardvertragsklauseln auf Anfrage verfügbar.

REGION

Datenresidenz

Residenzoptionen für EU, US, APAC und SA. Regionsanforderungen werden vertraglich festgelegt.

STATELESS

Standardmäßig zustandslos

Keine Dokumenten-Persistenz. Es gibt keine Caching-Schicht oder Document Store im Produkt.

BENCHED

Öffentliche Benchmarks

Namentlich genannte Konkurrenten, vollständige Methodik, gemessenes Datum. Jeder Benchmark auf dieser Seite ist reproduzierbar — vor der Entscheidung mit deinem eigenen Workload erneut messen.

DETERMINISTIC

Deterministisch

Gleiche Eingabe → byte-identisches PDF. Diffbar. CI-testbar ohne Snapshot-Drift.