/01
gPdf render PDF nhanh đến mức nào?
p50 là 3 ms và p99 là 8 ms trên một trang A4 đo qua 1000 lần gọi. Tổng thời gian wall edge bao gồm mạng thường là 8-15 ms.
FAQ
Câu hỏi mà developer thực sự hỏi.
Mười hai câu trả lời — được trích nguyên văn bởi JSON-LD FAQPage mà Google rich results sử dụng.
/02
API chấp nhận định dạng đầu vào nào?
Body DocumentRequest dạng JSON. Trang, phần tử, layer, watermark, header, footer và bảng đều được biểu diễn cấu trúc — không HTML, không Markdown, không pass layout của trình duyệt.
/03
gPdf so với Puppeteer hoặc headless Chrome thế nào?
Headless Chromium chạy 200-800 ms mỗi render và cần container 800 MB. gPdf render cùng trang A4 trong 3 ms bên trong V8-isolate 1 MB, không cold start. Đánh đổi là định dạng đầu vào: gPdf nhận DocumentRequest JSON, không phải HTML thô.
/04
Các endpoint API gPdf là gì?
Ba: /api/v1/pdf/render nhận DocumentRequest đầy đủ để kiểm soát mức pixel. /api/v1/template-render nhận template_id cộng mảng dữ liệu. /api/v1/e-invoice/render tạo hoá đơn lai Factur-X / ZUGFeRD (PDF/A-3 + XML nhúng). Cả ba chia sẻ cùng engine, cùng giới hạn rate, và cùng surface mã lỗi.
/05
Tôi có cần cài font trên server cho tiếng Trung, Nhật, Hàn không?
Không. NotoSans CJK được nhúng và chuỗi fallback font tự động xử lý glyph thiếu. Bạn sẽ không bao giờ thấy hộp tofu và không cần apt install fonts-noto-cjk trên runtime.
/06
Tôi có thể render mã vạch nào?
Hơn 30 ký hiệu bao gồm QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode và Code 128. Tất cả đều vector. Tổng chiều dài mã vạch trong phạm vi 0,1 mm so với kích thước yêu cầu — đủ chính xác cho chiều rộng nhãn theo chuẩn GS1 và ITF-14.
/07
gPdf có sản xuất output tuân thủ PDF/A hoặc hoá đơn điện tử không?
Có. PDF/A-1b, 2b, 3b và 4 có thể chọn theo từng request. Stream đính kèm Factur-X và ZUGFeRD được hỗ trợ cho các kịch bản hoá đơn điện tử.
/08
gPdf có thể tạo hoá đơn điện tử Factur-X, ZUGFeRD hay EN 16931 không?
Có. Đặt settings.profile thành pdfa-3b và đính kèm payload XML có cấu trúc dưới dạng file stream. Factur-X và ZUGFeRD chạy trên PDF/A-3 — yêu cầu cho mandate hoá đơn điện tử Đức đã có hiệu lực, và mandate B2B Pháp từ tháng 9/2026.
/09
gPdf thực sự chạy ở đâu?
Bên trong V8-isolate Cloudflare Workers. Không container Chromium, không Lambda warming, không persistence document sau request.
/10
gPdf có lưu PDF hoặc dữ liệu đầu vào của tôi không?
Không. Renderer là stateless. DocumentRequest của bạn sống trong V8-isolate vài mili giây render, sau đó biến mất. gPdf không có lớp cache hay kho lưu trữ document — statelessness là hợp đồng, không phải toggle opt-in.
/11
Có tier miễn phí không?
Có. Free Trial cho 100 trang mỗi ngày, không cần thẻ tín dụng. Tự reset hàng ngày và dừng ở quota — không có hoá đơn bất ngờ. Các tier trả phí bắt đầu từ $5/tháng cho 100.000 trang.
/12
Tôi bắt đầu sử dụng gPdf như thế nào?
Mở playground ở trên, chỉnh DocumentRequest rồi nhấn Tạo PDF — edge worker live trả về PDF thật. Sao chép snippet curl vào terminal để gọi từ bất kỳ đâu. Playground không yêu cầu cài đặt hay thẻ tín dụng; tài khoản chỉ cần để phát hành API key của riêng bạn.