/01
gPdf 渲染一份 PDF 有多快？
单页 A4 测量 1000 次：p50 3 毫秒、p99 8 毫秒。包含网络的边缘总耗时通常在 8 到 15 毫秒之间。
FAQ
开发者真正会问的问题。
12 条问答 — Google rich result 消费的 FAQPage JSON-LD 直接复用同一份文本。
/02
API 接受什么格式的入参？
JSON DocumentRequest。页面、元素、图层、水印、页眉页脚、表格全部用结构化字段描述——不走 HTML、不走 Markdown、不依赖浏览器排版。
/03
gPdf 和 Puppeteer / headless Chrome 比怎么样？
Headless Chromium 单次渲染 200 到 800 毫秒，需要一个 800 MB 容器。gPdf 在 1 MB 的 V8 isolate 里 3 毫秒完成同一页 A4，且无冷启动。代价是入参格式不同：gPdf 接 JSON DocumentRequest，不接原生 HTML。
/04
gPdf API 都有哪些端点？
三个：/api/v1/pdf/render 接收完整 DocumentRequest，适合像素级控制；/api/v1/template-render 接收 template_id 加 data 数组，适合模板已发布的场景；/api/v1/e-invoice/render 出 Factur-X / ZUGFeRD 混合发票（PDF/A-3 + 嵌入 XML）。三个端点共用同一渲染引擎、限额与错误码体系。
/05
中文、日文、韩文渲染需要在服务器上装字体吗？
不需要。NotoSans CJK 已内嵌，自动 fallback 链路处理缺失字形，永远不会出现豆腐字，也不需要 apt install fonts-noto-cjk。
/06
能渲染哪些条码？
30+ 种符号体系，包括 QR、GS1-128、PDF417、DataMatrix、Aztec、MaxiCode、Code 128。全部矢量绘制，条码整体长度与请求尺寸偏差不超过 0.1mm——足够对齐 GS1、ITF-14 等对宽度有硬性规格的标签。
/07
gPdf 能生成 PDF/A 或电子发票合规的输出吗？
可以。PDF/A-1b、2b、3b、4 都可按请求选择；Factur-X、ZUGFeRD 附件流支持电子发票场景。
/08
gPdf 能生成 Factur-X / ZUGFeRD / EN 16931 电子发票吗？
可以。把 settings.profile 设为 pdfa-3b，并以文件流附上结构化 XML 即可。Factur-X / ZUGFeRD 附件流基于 PDF/A-3——德国电子发票强制条款已生效，法国 B2B 强制条款于 2026 年 9 月起执行。
/09
gPdf 实际运行在哪里？
Cloudflare Workers V8 isolate 内。没有 Chromium 容器，没有 Lambda 预热，请求结束后文档不会驻留。
/10
gPdf 会保存我的 PDF 或入参数据吗？
不会。渲染器是无状态的。你的 DocumentRequest 只在 V8 isolate 里存在渲染那几毫秒，然后就消失。gPdf 没有缓存层、也没有文档存储——无状态是产品契约，不是一个可以开关的选项。
/11
有免费档吗？
有。免费试用每天 100 页、无需绑卡。每日自动重置，用尽即停——不会出现意外账单。付费档每月 100K 页、$5 起。
/12
怎么开始用 gPdf？
上面的 API 试用台，编辑 DocumentRequest 然后点「生成 PDF」——边缘 Worker 会返回真实 PDF。把 curl 片段复制到终端就能从任何地方调用。API 试用台免安装、无需信用卡；只有签发你自己的 API key 时才需要登录。