/01
¿Qué tan rápido renderiza gPdf un PDF?
El p50 es de 3 ms y el p99 de 8 ms en una sola página A4 medido sobre 1000 invocaciones. El tiempo total en el edge, incluyendo la red, suele ser de 8 a 15 ms.
FAQ
Preguntas que los desarrolladores realmente hacen.
Doce respuestas — citadas textualmente por el JSON-LD FAQPage que consumen los Google rich results.
/02
¿Qué formato de entrada acepta la API?
Un cuerpo DocumentRequest en JSON. Páginas, elementos, capas, marcas de agua, encabezados, pies y tablas se expresan estructuralmente — sin HTML, sin Markdown, sin paso de layout del navegador.
/03
¿Cómo se compara gPdf con Puppeteer o Chrome headless?
Chromium headless funciona a 200-800 ms por renderizado y necesita un contenedor de 800 MB. gPdf renderiza la misma página A4 en 3 ms dentro de un isolate V8 de 1 MB, sin arranque en frío. La compensación es el formato de entrada: gPdf toma un DocumentRequest JSON, no HTML crudo.
/04
¿Cuáles son los endpoints de la API gPdf?
Tres: /api/v1/pdf/render toma un DocumentRequest completo para control a nivel de píxel. /api/v1/template-render toma template_id más un array de datos para sistemas con un template publicado. /api/v1/e-invoice/render produce facturas híbridas Factur-X / ZUGFeRD (PDF/A-3 + XML embebido). Los tres comparten el mismo motor, los mismos límites de velocidad y la misma superficie de códigos de error.
/05
¿Necesito instalar fuentes en mi servidor para chino, japonés o coreano?
No. NotoSans CJK está embebido y una cadena de fallback automático maneja los glifos faltantes. Nunca verás cuadros tofu y no necesitas apt install fonts-noto-cjk en tu runtime.
/06
¿Qué códigos de barras puedo renderizar?
Más de 30 simbologías incluyendo QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode y Code 128. Todas vectoriales. La longitud total del código de barras está dentro de 0,1 mm del tamaño solicitado — suficientemente preciso para anchos de etiqueta GS1 e ITF-14.
/07
¿gPdf produce salidas conformes a PDF/A o factura electrónica?
Sí. PDF/A-1b, 2b, 3b y 4 son seleccionables por solicitud. Los flujos de adjuntos Factur-X y ZUGFeRD son compatibles para escenarios de factura electrónica.
/08
¿Puede gPdf producir facturas electrónicas Factur-X, ZUGFeRD o EN 16931?
Sí. Configura settings.profile en pdfa-3b y adjunta el payload XML estructurado como flujo de archivo. Factur-X y ZUGFeRD se basan en PDF/A-3 — requerido para el mandato alemán de e-facturación ya en vigor, y el mandato francés B2B desde septiembre de 2026.
/09
¿Dónde se ejecuta realmente gPdf?
Dentro de isolates V8 de Cloudflare Workers. No hay contenedor Chromium, ni calentamiento de Lambda, ni persistencia de documento después de la solicitud.
/10
¿gPdf almacena mis PDFs o datos de entrada?
No. El renderizador es sin estado. Tu DocumentRequest vive en un isolate V8 durante los pocos milisegundos del renderizado, luego desaparece. gPdf no tiene capa de caché ni almacenamiento de documentos — la ausencia de estado es el contrato, no una opción.
/11
¿Hay un nivel gratuito?
Sí. La prueba gratuita ofrece 100 páginas por día, sin tarjeta de crédito. Se reinicia diariamente y se detiene en el cuota — sin facturas sorpresa. Los niveles de pago comienzan en $5 al mes por 100.000 páginas.
/12
¿Cómo empiezo a usar gPdf?
Abre el playground arriba, edita el DocumentRequest y pulsa Generar PDF — el worker en vivo del edge devuelve un PDF real. Copia el snippet curl en tu terminal para llamarlo desde cualquier sitio. El playground no requiere instalación ni tarjeta de crédito; sólo se necesita una cuenta para emitir tu propia API key.