/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.
FAQ
Perguntas que desenvolvedores realmente fazem.
Doze respostas — citadas literalmente pelo JSON-LD FAQPage que os Google rich results consomem.
/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.