v2026.05 · API tạo PDF từ JSON

API nhanh nhất thế giới dành cho hóa đơn và nhãn vận chuyển số lượng lớn

100.000 trang với 5 USD. PDF được tạo ở edge trong vài mili giây

Được xây dựng cho quy mô toàn cầu Tuân thủ hoàn toàn PDF/A, Factur-X và ZUGFeRD

Thử API trực tiếp Xem tham chiếu API không thẻ tín dụng · không cài đặt · thân thiện curl
CPU / render (p50)
4.98ms · 24h
Request đã phục vụ
299/ 24h
Chi phí
$5 / 100K
Khu vực
300+ pops
30+ định dạng mã vạch 4 profile PDF/A 100K trang từ $5/tháng
Playground

Gửi JSON. Tạo PDF.
Tất cả năng lực cốt lõi trên một trang.

Chỉnh DocumentRequest ở bên trái. Gọi live edge worker
schema thật, PDF thật, thường <5 ms.

Tại sao gPdf

gPdf được xây dựng trên bốn trụ cột.

01 / 04
$5
per 100K pages

Chi phí

Chạy trên Cloudflare Workers — không phải container Chromium 800 MB tính phí $0,40/giờ chỉ để chờ. $0,00005 mỗi trang. Không tối thiểu, không tính theo ghế, không phụ phí theo môi trường.

02 / 04
PDF/A
1b · 2b · 3b · 4

Tiêu chuẩn

Hồ sơ lưu trữ PDF/A (1b, 2b, 3b, 4) theo yêu cầu. Factur-X, ZUGFeRD và EN 16931 được hỗ trợ native — Mục 5 trong tài liệu API, không phải mục roadmap.

03 / 04
JSON → PDF
API + editor, one schema

JSON-native

pages[], elements[], x/y theo milimét. Không HTML→PDF, không headless Chrome, không cần học DSL template. Cùng một JSON cấp cho API và trình soạn thảo trực quan — designer và developer cùng sửa một file.

04 / 04
3000+
color emoji, embedded

Kiểu chữ

Latin, CJK, Ả Rập (RTL + shaping phức tạp), Devanagari, Cyrillic, Bengali và Thái đều có sẵn trong engine — cộng thêm 3000+ emoji màu. Không cần `apt install fonts-noto-cjk`. Không bao giờ thiếu glyph.

Tính năng

Những chi tiết nền tảng nhưng quan trọng, được làm đúng.

Ngữ nghĩa document thật, không phải ảnh chụp browser trong wrapper PDF.

Browse use cases
/01

Kiểm soát từng pixel

x/y theo milimét, x_anchor cho căn lề phải, đặt vị trí sub-milimét trên nhãn. Là tọa độ, không phải xấp xỉ.

// inside elements[i]
"x_anchor": {
  "reference": "content_right",
  "offset": 6
}
/02

Mã vạch vector

30+ ký hiệu bao gồm GS1-128, QR, PDF417, DataMatrix. Tất cả vector. Tổng chiều dài chính xác 0,1 mm.

// 30+ formats: code128, qrcode, datamatrix, pdf417, ...
"type": "barcode",
"format": "code128",
"content": "INV-2026-001"
Why vector beats raster
/03

Chuỗi fallback font

font_mode: strict (font khai báo phải phủ mọi glyph), prefer (dự phòng qua các font tích hợp), auto (engine tự chọn). Auto/prefer cạn lựa chọn sẽ trả về API-504 — thất bại minh bạch, không im lặng.

// inside style{}
"font_family": "NotoSans-Regular",
"font_mode": "prefer"
/04

Chế độ tuân thủ

settings.profile = "pdfa-3b" kích hoạt tuân thủ PDF/A-3b cùng luồng tệp đính kèm XML mà Factur-X / ZUGFeRD yêu cầu. Một trường, một tài liệu tuân thủ.

// top-level on DocumentRequest
"settings": {
  "profile": "pdfa-3b"
}
PDF/A and Factur-X, explained
/05

Biến + phân trang

{page} / {total_pages} được giải sau layout. keep_together, widow/orphan, khối page_break.

// element of type "variable"
{ "type": "variable",
  "name": "page",
  "scope": "system" }
/06

Bảng phân trang

row_span qua các trang, lặp header, alternate_fill, viền đôi composite. 1 % luôn bị hỏng.

// inside table element
"pagination": {
  "keep_spans_together": true
}
/07

Một JSON, hai giao diện

Cùng một JSON DocumentRequest điều khiển POST /api/v1/pdf/render và trình soạn thảo trực quan tại editor.gpdf.com. Sửa trực quan, gửi qua API hoặc viết tay — cả ba đường đều round-trip cùng một file.

// three routes, one engine
POST /api/v1/pdf/render
POST /api/v1/template-render
POST /api/v1/e-invoice/render
Read the API reference
/08

Xây dựng cho hoá đơn

$0,00005 mỗi trang, p50 3 ms, CJK nhúng, stream đính kèm PDF/A-3. Bốn con số mà các nhóm fintech, ERP, và compliance thuế kiểm tra đầu tiên.

// invoice — header + table pattern
{ "size": "a4",
  "elements": [
    { "type": "text",  "x": 18, "y": 22, ... },
    { "type": "table", "x": 18, "y": 60, ... }
  ]}
Why JSON beats HTML→PDF
/09

Xây dựng cho nhãn vận chuyển

Preset kích thước label_100_150 và label_4_6_in. GS1-128, ITF-14, SSCC vector với độ chính xác 0,1 mm — hãng vận chuyển và 3PL in ở giờ cao điểm mà không cần mã vạch raster.

// 4×6 thermal shipping label
{ "size": "label_4_6_in",
  "elements": [{
    "type": "barcode",
    "format": "code128",
    "content": "1Z999AA10123456784" }]}
Shipping-label use case
Benchmark · sampled 2026-04-29

Đo lường, không phải marketing.

Hóa đơn A4 1 trang, 12 dòng, QR + logo. Trung vị của 1000 lần tạo PDF. Càng thấp càng tốt.

Methodology: 1-page A4 invoice · 12 line items · 1 QR + 1 logo · 1K invocations · median (p50) and p99 reported. Sampled 2026-04-29 from a workstation in EU-WEST. PDFShift, DocRaptor, Puppeteer and LaTeX numbers are reproduced from each vendor's published quickstart sample with the same input — re-run on your own workload before deciding. Read the head-to-head comparisons →

0 105ms 210ms 315ms 420ms
01 gPdf ours
3.8ms
02 PDFShift
95ms
03 DocRaptor (Prince)
180ms
04 Puppeteer (headless)
312ms
05 LaTeX (local)
420ms
Giá

Trả tiền cho trang. Không gì khác.

Không per-seat. Không per-environment. Không gatekeeping tier hỗ trợ.

Tất cả các tier trả phí bao gồm cùng 100.000 trang và cùng giới hạn render. Chúng chỉ khác nhau ở tuỳ chỉnh metadata, sự sẵn có của profile PDF/A, và tỷ lệ vượt quota.

Free Trial

/free
$0 mãi mãi

100 trang / ngày · dừng ở quota.

  • +100 trang / ngày · auto-reset
  • +Playground + đánh giá API
  • +Không cần thẻ
  • +Email support · SLA 1 ngày làm việc
Thử Playground

Basic

/basic
$5 / tháng

100.000 trang / tháng bao gồm.

  • +100.000 trang / tháng bao gồm
  • +Vượt quota $0.00005 mỗi trang
  • +Metadata PDF chuẩn · không tuỳ chỉnh
  • +Chỉ PDF chuẩn · không có profile PDF/A
  • +Email support · SLA 1 ngày làm việc
Đăng ký

Pro

/pro
$8 / tháng

100.000 trang / tháng bao gồm. Metadata tuỳ chỉnh.

  • +100.000 trang / tháng bao gồm
  • +Vượt quota $0.00008 mỗi trang
  • +Tiêu đề · chủ đề · người tạo tuỳ chỉnh
  • +Chỉ PDF chuẩn · không có profile PDF/A
  • +Email support · SLA 1 ngày làm việc
Đăng ký

Enterprise

/ent
$12 / tháng

100.000 trang / tháng bao gồm. PDF/A + metadata đầy đủ.

  • +100.000 trang / tháng bao gồm
  • +Vượt quota $0.00012 mỗi trang
  • +Cả 6 trường metadata hoàn toàn tuỳ chỉnh
  • +PDF/A-1b · 2b · 3b · 4 được kích hoạt
  • +Email support · SLA 1 ngày làm việc
Đăng ký
Triển khai riêng tư

Cần chạy gPdf trong phạm vi mạng riêng của bạn?

Dành cho đội ngũ chịu quản lý, triển khai private cloud/VPC và môi trường intranet cách ly. gPdf có thể chạy dưới dạng Worker, server hoặc triển khai sau gateway chuyên dụng; kiểm soát mạng, yêu cầu khu vực, điều khoản DPA và escalation hỗ trợ được xác định theo từng dự án.

  • +Private cloud, VPC hoặc mạng cách ly
  • +Triển khai Worker/server chuyên dụng
  • +Điều khoản DPA và kiểm soát lưu trú dữ liệu
  • +Mô hình hỗ trợ thống nhất từ đầu
Liên hệ triển khai riêng tư · soon
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.

/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.

/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.

Từ blog

Bài luận engineering, mới.

Xem tất cả bài viết
  1. Chọn API PDF năm 2026: 8 câu hỏi nên đặt ra

    Một khung quyết định trung lập để chọn API tạo PDF. Tám câu hỏi giúp dự đoán bạn có còn hài lòng sau 12 tháng hay không.

  2. gPdf vs DocRaptor: vì sao edge rendering thắng HTML-to-PDF

    DocRaptor dùng Prince để chuyển HTML sang PDF trên hosted backend. gPdf render structured JSON trực tiếp tại Cloudflare edge. Chênh lệch giá 18× và không phải teaser.

  3. Giải thích PDF/A và Factur-X cho kỹ sư, không dùng ngôn ngữ pháp lý

    PDF/A profiles thật sự ràng buộc gì, vì sao Factur-X quan trọng với e-invoicing ở châu Âu, và pipeline nhỏ nhất để tạo PDF compliant từ JSON renderer.

Tin tưởng

Compliance và lưu trú dữ liệu

Engineering có thể audit cộng giấy tờ — cả hai sổ đăng ký, cả hai có thể xác minh.

SOC2

SOC 2 Type II

Audit lên lịch Q3 2026 · bằng chứng theo yêu cầu.

GDPR

GDPR + DPA

Điều khoản hợp đồng tiêu chuẩn có sẵn theo yêu cầu.

REGION

Lưu trú dữ liệu

Tùy chọn lưu trú dữ liệu tại EU, US, APAC và SA. Yêu cầu khu vực được xác định trong hợp đồng.

STATELESS

Stateless mặc định

Không persistence document. Không có lớp cache hay kho lưu trữ document trong sản phẩm.

BENCHED

Benchmark công khai

Đối thủ được nêu tên, phương pháp đầy đủ, ngày lấy mẫu. Mỗi benchmark trên trang này có thể tái tạo — chạy lại trên workload của bạn trước khi quyết định.

DETERMINISTIC

Tất định

Cùng input → PDF giống nhau từng byte. Có thể diff. Có thể test trong CI mà không drift snapshot.