v2026.05 · API de geração de PDF a partir de JSON

A API mais rápida do mundo para faturas e etiquetas de alto volume

100 mil páginas por US$ 5. PDFs gerados na borda em poucos milissegundos

Construída para escala global Totalmente em conformidade com PDF/A, Factur-X e ZUGFeRD

Experimentar a API ao vivo Ver referência da API sem cartão de crédito · sem instalação · amigo do curl
CPU / render (p50)
4.98ms · 24h
Requisições atendidas
299/ 24h
Custo
$5 / 100K
Regiões
300+ pops
30+ formatos de código de barras 4 perfis PDF/A 100K páginas a partir de $5/mês
Playground

Envie JSON. Gere um PDF.
Capacidades essenciais, todas em uma página.

Edite o DocumentRequest à esquerda. Chame o worker de borda em tempo real
schema real, PDF real, normalmente <5 ms.

Por que gPdf

gPdf assenta em quatro pilares.

01 / 04
$5
per 100K pages

Custo

Roda no Cloudflare Workers — não um container Chromium de 800 MB faturando $0,40/hora sem fazer nada. $0,00005 por página. Sem mínimos, sem custo por assento, sem sobretaxas por ambiente.

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

Padrões

Perfis de arquivamento PDF/A (1b, 2b, 3b, 4) sob demanda. Factur-X, ZUGFeRD e EN 16931 suportados nativamente — Seção 5 da referência API, não um link no roadmap.

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

JSON nativo

pages[], elements[], x/y em milímetros. Sem HTML→PDF, sem Chrome headless, sem DSL de templates para aprender. O mesmo JSON alimenta a API e o editor visual — designers e desenvolvedores editam um único arquivo.

04 / 04
3000+
color emoji, embedded

Tipografia

Latim, CJK, árabe (RTL + ligaduras complexas), devanágari, cirílico, bengali e tailandês integrados ao motor — mais 3000+ emojis coloridos. Sem `apt install fonts-noto-cjk`. Nunca um glifo faltando.

Recursos

Os detalhes essenciais, bem feitos.

Semântica de documento real, não capturas de navegador num wrapper PDF.

Browse use cases
/01

Controle ao pixel

x/y em milímetros, x_anchor para alinhamento à direita, posicionamento submilimétrico em etiquetas. Coordenadas, não aproximações.

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

Códigos de barras vetoriais

30+ simbologias incl. GS1-128, QR, PDF417, DataMatrix. Todos vetoriais. Comprimento total preciso a 0,1 mm.

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

Cadeia de fallback de fontes

font_mode: strict (a família declarada deve cobrir todos os glifos), prefer (recorre às famílias integradas), auto (motor escolhe). Esgotamento de auto/prefer retorna API-504 — falha explícita, não silenciosa.

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

Modos de conformidade

settings.profile = "pdfa-3b" ativa a conformidade PDF/A-3b mais o fluxo de anexos XML incorporado que Factur-X / ZUGFeRD requerem. Um campo, um documento conforme.

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

Variáveis + paginação

{page} / {total_pages} resolvidos pós-layout. keep_together, widow/orphan, blocos page_break.

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

Tabelas que paginam

row_span entre páginas, cabeçalhos repetidos, alternate_fill, bordas duplas compostas. O 1 % que sempre quebra.

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

Um JSON, duas superfícies

O mesmo JSON DocumentRequest impulsiona POST /api/v1/pdf/render e o editor visual em editor.gpdf.com. Edite visualmente, entregue via API ou escreva à mão — os três fluxos round-trippam o mesmo arquivo.

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

Construído para faturas

$0,00005 por página, p50 3 ms, CJK embutido, fluxo de anexo PDF/A-3. Os quatro números que equipes fintech, ERP e compliance fiscal verificam primeiro.

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

Construído para etiquetas de envio

Presets de tamanho label_100_150 e label_4_6_in. GS1-128, ITF-14, SSCC vetoriais com precisão de 0,1 mm — transportadoras e 3PLs imprimem no pico sem códigos de barras rasterizados.

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

Medido, não marketado.

Fatura A4 de 1 página, 12 itens, QR + logo. Mediana de 1000 gerações de PDF. Quanto menor, melhor.

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
Preços

Pague por páginas. Nada mais.

Sem per-seat. Sem per-environment. Sem gatekeeping por nível de suporte.

Todos os planos pagos incluem as mesmas 100.000 páginas e os mesmos limites de renderização. Diferem apenas em personalização de metadados, disponibilidade de perfis PDF/A e tarifa de excesso.

Free Trial

/free
$0 para sempre

100 páginas / dia · para na cota.

  • +100 páginas / dia · auto-reset
  • +Playground + avaliação API
  • +Sem cartão necessário
  • +Suporte por email · SLA 1 dia útil
Experimentar Playground

Basic

/basic
$5 / mês

100.000 páginas / mês incluídas.

  • +100.000 páginas / mês incluídas
  • +Excesso $0.00005 por página
  • +Metadados PDF padrão · não personalizáveis
  • +Apenas PDF padrão · sem perfis PDF/A
  • +Suporte por email · SLA 1 dia útil
Assinar

Pro

/pro
$8 / mês

100.000 páginas / mês incluídas. Metadados personalizáveis.

  • +100.000 páginas / mês incluídas
  • +Excesso $0.00008 por página
  • +Título · assunto · criador personalizáveis
  • +Apenas PDF padrão · sem perfis PDF/A
  • +Suporte por email · SLA 1 dia útil
Assinar

Enterprise

/ent
$12 / mês

100.000 páginas / mês incluídas. PDF/A + metadados completos.

  • +100.000 páginas / mês incluídas
  • +Excesso $0.00012 por página
  • +Os 6 campos de metadados totalmente personalizáveis
  • +PDF/A-1b · 2b · 3b · 4 habilitados
  • +Suporte por email · SLA 1 dia útil
Assinar
Deploy privado

Precisa do gPdf dentro do seu próprio perímetro?

Para equipes reguladas, implantações em cloud privada/VPC e ambientes de intranet isolados. Rode o gPdf como um deploy dedicado em Worker, servidor ou atrás de um gateway; controles de rede, requisitos de região, termos de DPA e escalonamento de suporte são definidos por projeto.

  • +Cloud privada, VPC ou rede isolada
  • +Deploy dedicado Worker/servidor
  • +Termos de DPA e controles de residência
  • +Modelo de suporte definido antecipadamente
Contato para deploy privado · soon
FAQ

Perguntas que desenvolvedores realmente fazem.

Doze respostas — citadas literalmente pelo JSON-LD FAQPage que os Google rich results consomem.

/01

Quão rápido o gPdf renderiza um PDF?

O p50 é de 3 ms e o p99 de 8 ms numa única página A4 medido sobre 1000 invocações. O tempo total no edge, incluindo rede, é tipicamente de 8 a 15 ms.

/02

Que formato de entrada a API aceita?

Um corpo DocumentRequest em JSON. Páginas, elementos, camadas, marcas d'água, cabeçalhos, rodapés e tabelas são todos expressos estruturalmente — sem HTML, sem Markdown, sem passe de layout do navegador.

/03

Como o gPdf se compara ao Puppeteer ou Chrome headless?

Chromium headless roda em 200-800 ms por renderização e precisa de um container de 800 MB. O gPdf renderiza a mesma página A4 em 3 ms dentro de um isolate V8 de 1 MB, sem cold start. O trade-off é o formato de entrada: gPdf aceita um DocumentRequest JSON, não HTML cru.

/04

Quais são os endpoints da API gPdf?

Três: /api/v1/pdf/render aceita um DocumentRequest completo para controle ao nível do pixel. /api/v1/template-render aceita template_id mais um array de dados para sistemas com template publicado. /api/v1/e-invoice/render produz faturas híbridas Factur-X / ZUGFeRD (PDF/A-3 + XML embutido). Os três compartilham o mesmo motor, os mesmos limites de taxa e a mesma superfície de códigos de erro.

/05

Preciso instalar fontes no servidor para chinês, japonês ou coreano?

Não. NotoSans CJK está embutido e uma cadeia de fallback automático trata glifos faltantes. Você nunca verá caixas tofu e não precisa de apt install fonts-noto-cjk no seu runtime.

/06

Quais códigos de barras posso renderizar?

Mais de 30 simbologias incluindo QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode e Code 128. Todos vetoriais. O comprimento total do código de barras está dentro de 0,1 mm do tamanho solicitado — preciso o suficiente para larguras de etiqueta especificadas por GS1 e ITF-14.

/07

O gPdf produz saídas conformes PDF/A ou fatura eletrônica?

Sim. PDF/A-1b, 2b, 3b e 4 são selecionáveis por requisição. Fluxos de anexo Factur-X e ZUGFeRD são suportados para cenários de fatura eletrônica.

/08

O gPdf pode produzir faturas Factur-X, ZUGFeRD ou EN 16931?

Sim. Defina settings.profile como pdfa-3b e anexe o payload XML estruturado como fluxo de arquivo. Factur-X e ZUGFeRD baseiam-se em PDF/A-3 — exigido pelo mandato alemão de e-fatura já em vigor, e pelo mandato francês B2B desde setembro de 2026.

/09

Onde o gPdf realmente roda?

Dentro de isolates V8 do Cloudflare Workers. Sem container Chromium, sem warming de Lambda, e sem persistência de documento após a requisição.

/10

O gPdf armazena meus PDFs ou dados de entrada?

Não. O renderizador é stateless. Seu DocumentRequest vive num isolate V8 pelos poucos milissegundos da renderização, depois desaparece. O gPdf não tem camada de cache nem armazenamento de documentos — a ausência de estado é o contrato, não uma opção.

/11

Existe um nível gratuito?

Sim. O Free Trial dá 100 páginas por dia, sem cartão de crédito. Reseta diariamente e para na cota — sem fatura surpresa. Os planos pagos começam em $5 por mês para 100.000 páginas.

/12

Como começo a usar o gPdf?

Abra o playground acima, edite o DocumentRequest e clique em Gerar PDF — o worker em vivo do edge devolve um PDF real. Copie o snippet curl no seu terminal para chamá-lo de qualquer lugar. O playground não exige instalação nem cartão de crédito; uma conta só é necessária para emitir sua própria API key.

Do blog

Ensaios de engenharia, recentes.

Ver todos os posts
  1. Como escolher uma API de PDF em 2026: 8 perguntas essenciais

    Um framework neutro para escolher uma API de geração de PDF. As oito perguntas que indicam se você continuará satisfeito em 12 meses.

  2. gPdf vs DocRaptor: por que renderização no edge vence HTML-para-PDF

    DocRaptor usa Prince para converter HTML em PDF em backend hospedado. gPdf renderiza JSON estruturado diretamente no edge da Cloudflare. A diferença de preço é 18×. Aqui está por que isso não é uma isca.

  3. PDF/A e Factur-X / NF-e explicados para engenheiros (sem o jargão jurídico)

    O que perfis PDF/A realmente restringem, por que Factur-X torna-se obrigatório na UE em 2026, e o pipeline mais prático para emitir compliant a partir de um renderer JSON.

Confiança

Compliance e residência de dados

Engenharia auditável mais a papelada — ambos os registros, ambos verificáveis.

SOC2

SOC 2 Type II

Auditoria agendada para Q3 2026 · evidência sob solicitação.

GDPR

GDPR + DPA

Cláusulas contratuais padrão disponíveis sob solicitação.

REGION

Residência de dados

Opções de residência na UE, US, APAC e SA. Requisitos de região são definidos em contrato.

STATELESS

Stateless por padrão

Sem persistência de documentos. Não há camada de cache nem armazenamento de documentos no produto.

BENCHED

Benchmarks públicos

Concorrentes nomeados, metodologia completa, data de amostragem. Cada benchmark desta página é reproduzível — re-execute na sua própria carga antes de decidir.

DETERMINISTIC

Determinístico

Mesma entrada → PDF byte-idêntico. Diffável. Testável em CI sem deriva de snapshot.