DocRaptor 很适合 HTML/CSS 作为源头的产品

DocRaptor 是成熟产品，底层使用 PrinceXML。它适合源文件已经是 HTML、CSS 打印规则本来就是创作流程的一部分，或者输出是长篇书籍、手册、宣传册和报告的场景。

产品问题是：你的业务文档是否真的需要 HTML/CSS 排版引擎。物流面单、电商收据、发票、票券和对账单通常是结构化数据、精确位置、表格、金额和条码。对这类负载，一个不携带完整浏览器或分页媒体模型的文档生成 API 往往更直接。

同样输出 PDF，产品边界不同

DocRaptor 的边界是 HTML/CSS 转 PDF。你编写或生成 HTML，调试打印 CSS，把文档发给 API，然后拿到 PrinceXML 渲染出的 PDF。

gPdf 的边界是结构化数据到 PDF。你发送 DocumentRequest 或 template_id + data，Edge 渲染器负责字体、条码、页面几何、PDF/A 配置、电子发票封装、密码保护输出和元数据控制。

产品适配：印刷出版 vs 运营文档

当 PDF 必须保留已有 HTML/CSS 源头，尤其是长篇文字、目录、页码引用和高级印刷排版时，DocRaptor 更合适。

当 PDF 是从数据生成的运营文档，例如发票、物流面单、收据、票券、证书、装箱单、对账单或合规附件时，gPdf 更合适。JSON 模板通常比 HTML 打印规则更贴近真实业务模型。

开发时间：CSS Paged Media vs 模板工作流

DocRaptor 在团队已有 HTML 模板和 CSS 经验时效率很高。但当业务文档需要精确坐标、可扫描条码、重复字段、区域变体和频繁模板修改时，工作会变重。

gPdf 支持更贴近文档结构的流程。开发者可以编写 JSON，用面向 AI agent 的提示词起草符合 gPdf schema 的布局，再在 gPdf Studio 中通过添加和拖拽元素做视觉调整。生产侧继续用 template_id + data 调用模板。

价格模型：按文档 API vs 基础设施式按页计费

DocRaptor 公开套餐按文档计费。截至 2026-05-25，公开 Silver 方案列出每月 1,000 美元含 4 万份文档，超额文档每份 2.5 美分；10 万份单页文档约 2,500 美元，定制报价可能不同。

gPdf 按基础设施规模给结构化 PDF 生成定价。公开 Basic 方案每月 5 美元包含 10 万页，标准超额从每页 0.00005 美元起。差异不是促销折扣，而是数据型文档不需要为重量级 HTML/CSS 引擎付费。

Edge 生成与运营成本

DocRaptor 让你不用自己运营 PrinceXML，这是有价值的。取舍是每份文档仍然经过一个按文档计价的高级 HTML 转 PDF API。

gPdf 的 Rust/WASM 渲染器足够小，可以作为 Edge 服务运行。对结构化 PDF 来说，这意味着更低单页成本、更靠近用户的延迟，以及不需要在自己的基础设施里维护浏览器或排版容器。

通常决定选择的功能点

DocRaptor 的决定性能力是 CSS Paged Media、HTML 源文件兼容、长篇文字流、自动目录、脚注和印刷出版控制。

gPdf 的决定性能力是模板 + 数据生成、矢量条码、CJK 和多语言字体回退、PDF/A 配置、Factur-X/ZUGFeRD、密码保护 PDF、元数据控制，以及 gPdf Studio 的可视化 PDF 设计。

DocRaptor 明显更合适的场景

gPdf 的 JSON 模型不是为复杂多页流式文本、自动孤行寡行控制和出版级排版设计的。如果你是出版社，要把文章生成书籍，或要生成 300 页技术手册并带动态页码交叉引用，DocRaptor 更合适。

但如果你生成的是物流面单、B2B 发票、收据、票券或数字证书，gPdf 的结构化渲染路径更直接。

价格与资料来源说明

竞争对手价格会变化。本文中的 DocRaptor 数字已按 2026-05-25 的公开价格核对，属于标价估算，不是私下报价。采购前应重新核对供应商页面。DocRaptor、PrinceXML 及相关商标归各自权利人所有，本文比较不代表其背书。

FAQ

DocRaptor 更适合 HTML 文档吗？ 是的，当 HTML/CSS 是源头且输出需要高级分页媒体行为时，DocRaptor 更适合。gPdf 有意专注结构化 JSON 文档。

为什么 10 万份文档的价格差异这么大？ DocRaptor 按文档计费，并使用高级 HTML/CSS 引擎。gPdf 按结构化页面生成计费，Basic 方案 5 美元包含 10 万页。

迁移是否意味着重写所有模板？ 不一定。多数业务模板是布局加数据插值。布局变成 gPdf 模板，数据模型通常可以保留。

迁移形状

从 DocRaptor 迁移到 gPdf，本质是从 HTML 模板转向 JSON 模板：

- // Before: POST massive HTML string to DocRaptor
- const res = await fetch("https://docraptor.com/docs", {
-   method: "POST",
-   body: JSON.stringify({
-     document_content: "<html><body><h1>Invoice...</h1>...</body></html>",
-     name: "invoice.pdf",
-     document_type: "pdf"
-   })
- });

+ // After: POST structured JSON data to gPdf's edge
+ const res = await fetch('https://api.gpdf.com/api/v1/template-render', {
+   method: 'POST',
+   headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
+   body: JSON.stringify({ template_id: 'invoice-v2', data: { total: 100.00 } }),
+ });

维度	gPdf	DocRaptor	更胜一筹
最佳产品适配	从数据生成结构化文档：发票、收据、物流面单、票券、对账单	HTML/CSS 文档、长篇印刷排版、书籍、手册和已有网页模板	并列
核心排版引擎 gPdf 的底层架构不使用 HTML/CSS 排版链路，避免把结构化业务文档交给完整 CSS 级联和分页排版流程处理。	WASM + Rust Edge Isolate	PrinceXML HTML/CSS 引擎	gPdf
10 万份单页文档的成本公开价格核对时间：2026-05-25。DocRaptor 按文档计费，不按页计费；Silver 公开方案为每月 1,000 美元含 4 万份文档，超额每份 2.5 美分。	5 美元（Basic 方案，含 10 万页）	按当前 Silver + 超额计费约 2,500 美元；定制报价可能不同	gPdf
集成与创作成本 gPdf 的官方提示词可帮助生成符合 gPdf schema 的 JSON 布局，再用编辑器做视觉调整。DocRaptor 在源文件本来就是 HTML/CSS 时更有优势。	面向 AI agent 的提示词 + 可视化编辑器，辅助生成 JSON 模板	需要编写 HTML 与 CSS Paged Media 规则	gPdf
电子发票（Factur-X / ZUGFeRD）	原生 Factur-X / ZUGFeRD 端点；在 PDF/A-3b 中嵌入 CII XML	未在公开 API 文档中确认同等 Factur-X / ZUGFeRD 端点；需要自行后处理	gPdf
矢量条形码	原生内置 30 多种标准条码（GS1-128、QR、DataMatrix 等）	依赖 JavaScript 栅格化或外部 SVG	gPdf
彩色 Emoji 表情符号	内置 3000 多个彩色 Emoji 字形	依赖服务器或操作系统字体回退；不同环境可能出现缺字或黑白回退	gPdf
印刷级书籍、画册与流式排版如果您需要生成一本 500 页的书籍，要求自动控制孤行寡行、多语言连字符和动态目录，PrinceXML 是成熟选择。	不支持	支持成熟 —— PrinceXML 的强项	DocRaptor

gPdf vs DocRaptor

并排看

什么时候选谁