/01
Jak szybko gPdf renderuje PDF?
p50 to 3 ms, p99 to 8 ms na pojedynczej stronie A4 mierzone na 1000 wywołaniach. Łączny czas edge z siecią to zwykle 8-15 ms.
FAQ
Pytania, które programiści rzeczywiście zadają.
Dwanaście odpowiedzi — cytowanych dosłownie przez JSON-LD FAQPage konsumowany przez Google rich results.
/02
Jaki format wejściowy akceptuje API?
Body DocumentRequest w JSON. Strony, elementy, warstwy, znaki wodne, nagłówki, stopki i tabele wyrażane są strukturalnie — bez HTML, bez Markdown, bez przebiegu layoutu przeglądarki.
/03
Jak gPdf porównuje się do Puppeteer lub headless Chrome?
Headless Chromium działa 200-800 ms na render i potrzebuje kontenera 800 MB. gPdf renderuje tę samą stronę A4 w 3 ms wewnątrz isolatu V8 1 MB, bez zimnego startu. Kompromis to format wejściowy: gPdf przyjmuje JSON DocumentRequest, nie surowy HTML.
/04
Jakie są endpointy API gPdf?
Trzy: /api/v1/pdf/render przyjmuje pełny DocumentRequest do kontroli na poziomie piksela. /api/v1/template-render przyjmuje template_id plus tablicę danych. /api/v1/e-invoice/render produkuje hybrydowe faktury Factur-X / ZUGFeRD (PDF/A-3 + osadzony XML). Wszystkie trzy dzielą ten sam silnik, te same limity i tę samą powierzchnię kodów błędów.
/05
Czy muszę instalować czcionki na serwerze dla chińskiego, japońskiego lub koreańskiego?
Nie. NotoSans CJK jest osadzony, a automatyczny łańcuch fallback obsługuje brakujące glify. Nigdy nie zobaczysz tofu boxów i nie potrzebujesz apt install fonts-noto-cjk na runtime.
/06
Jakie kody kreskowe mogę renderować?
Ponad 30 symboliki w tym QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode i Code 128. Wszystkie wektorowe. Łączna długość kodu kreskowego mieści się w 0,1 mm żądanego rozmiaru — wystarczająco precyzyjna dla szerokości etykiet określonych przez GS1 i ITF-14.
/07
Czy gPdf produkuje wyjścia zgodne z PDF/A lub e-fakturą?
Tak. PDF/A-1b, 2b, 3b i 4 wybierane na żądanie. Strumienie załączników Factur-X i ZUGFeRD są obsługiwane dla scenariuszy e-faktury.
/08
Czy gPdf może produkować faktury Factur-X, ZUGFeRD lub EN 16931?
Tak. Ustaw settings.profile na pdfa-3b i dołącz strukturyzowany payload XML jako strumień plików. Factur-X i ZUGFeRD bazują na PDF/A-3 — wymagane dla niemieckiego mandatu e-faktury już obowiązującego i francuskiego mandatu B2B od września 2026.
/09
Gdzie naprawdę działa gPdf?
W isolatach V8 Cloudflare Workers. Bez kontenera Chromium, bez warmingu Lambda, bez persystencji dokumentu po żądaniu.
/10
Czy gPdf przechowuje moje PDF lub dane wejściowe?
Nie. Renderer jest stateless. Twój DocumentRequest żyje w isolacie V8 przez kilka milisekund renderingu, potem znika. gPdf nie ma warstwy cache ani magazynu dokumentów — bezstanowość to kontrakt, nie opcja.
/11
Czy jest darmowy poziom?
Tak. Free Trial daje 100 stron dziennie, bez karty kredytowej. Resetuje się codziennie i zatrzymuje na limicie — bez niespodziewanych rachunków. Płatne poziomy zaczynają się od $5 miesięcznie za 100 000 stron.
/12
Jak zacząć używać gPdf?
Otwórz playground powyżej, edytuj DocumentRequest i naciśnij Utwórz PDF — żywy edge-worker zwraca prawdziwy PDF. Skopiuj snippet curl do swojego terminala, by wywoływać go skądkolwiek. Playground nie wymaga instalacji ani karty kredytowej; konto potrzebne jest tylko do wydania własnego klucza API.