/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.
FAQ
Fragen, die Entwickler wirklich stellen.
Zwölf Antworten — wörtlich zitiert vom JSON-LD FAQPage, das Google Rich Results konsumiert.
/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.