v2026.05 · API de génération de PDF depuis JSON

L'API la plus rapide au monde pour les factures et étiquettes à grand volume

100 000 pages pour 5 $. Des PDF générés à l’edge en quelques millisecondes

Conçue pour une échelle mondiale Entièrement conforme avec PDF/A, Factur-X et ZUGFeRD

Essayer l'API en direct Voir la référence API sans carte bancaire · sans installation · compatible curl
CPU / rendu (p50)
4.98ms · 24h
Requêtes servies
299/ 24h
Coût
$5 / 100K
Régions
300+ pops
30+ formats de codes-barres 4 profils PDF/A 100K pages dès 5 $/mois
Playground

Envoyez du JSON. Générez un PDF.
Les capacités clés, toutes sur une seule page.

Modifiez le DocumentRequest à gauche. Appelez le worker edge en direct
vrai schéma, vrai PDF, typiquement <5 ms.

Pourquoi gPdf

gPdf repose sur quatre piliers.

01 / 04
$5
per 100K pages

Coût

Tourne sur Cloudflare Workers — pas un conteneur Chromium de 800 Mo facturé 0,40 $/heure à ne rien faire. 0,00005 $ par page. Pas de minimum, pas de licence par siège, pas de surcoût par environnement.

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

Conformité

Profils d'archivage PDF/A (1b, 2b, 3b, 4) à la demande. Factur-X, ZUGFeRD et EN 16931 nativement supportés — Section 5 de la référence API, pas un lien sur la feuille de route.

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

JSON natif

pages[], elements[], x/y en millimètres. Pas de HTML→PDF, pas de Chrome headless, pas de DSL de templates à apprendre. Le même JSON alimente l'API et l'éditeur visuel — designers et développeurs éditent le même fichier.

04 / 04
3000+
color emoji, embedded

Typographie

Latin, CJK, arabe (RTL + ligatures complexes), devanagari, cyrillique, bengali et thaï embarqués dans le moteur — plus 3000+ emojis en couleur. Pas de `apt install fonts-noto-cjk`. Aucun glyphe manquant, jamais.

Fonctionnalités

Les détails essentiels, bien exécutés.

Vraie sémantique de document, pas des captures de navigateur dans un wrapper PDF.

Browse use cases
/01

Contrôle au pixel près

x/y en millimètres, x_anchor pour l'alignement à droite, placement sub-millimétrique sur les étiquettes. Des coordonnées, pas des approximations.

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

Codes-barres vectoriels

30+ symbologies dont GS1-128, QR, PDF417, DataMatrix. Tous vectoriels. Longueur totale précise à 0,1 mm.

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

Chaîne de repli des polices

font_mode : strict (la famille déclarée doit couvrir tous les glyphes), prefer (repli sur les familles embarquées), auto (le moteur choisit). L'épuisement auto/prefer retourne API-504 — échec explicite, pas silencieux.

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

Modes de conformité

settings.profile = "pdfa-3b" déclenche la conformité PDF/A-3b et le flux de pièces jointes XML embarqué que Factur-X / ZUGFeRD exigent. Un champ, un document conforme.

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

Variables + pagination

{page} / {total_pages} résolus après mise en page. keep_together, widow/orphan, blocs page_break.

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

Tableaux qui paginent

row_span entre les pages, en-têtes répétés, alternate_fill, bordures doubles composées. Le 1 % qui casse toujours.

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

Un JSON, deux surfaces

Le même JSON DocumentRequest pilote POST /api/v1/pdf/render et l'éditeur visuel sur editor.gpdf.com. Éditez visuellement, livrez par API, ou écrivez à la main — les trois flux round-trippent le même fichier.

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

Conçu pour les factures

0,00005 $ par page, p50 3 ms, CJK intégré, flux d'attachement PDF/A-3. Les quatre chiffres que les équipes fintech, ERP et conformité fiscale vérifient en premier.

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

Conçu pour les étiquettes d'expédition

Presets de tailles label_100_150 et label_4_6_in. GS1-128, ITF-14, SSCC vectoriels à 0,1 mm de précision — transporteurs et 3PL impriment en pointe sans codes-barres rasterisés.

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

Mesuré, pas marketé.

Facture A4 d’une page, 12 lignes, QR + logo. Médiane de 1000 générations de PDF. Plus bas est meilleur.

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
Tarifs

Payez pour les pages. Rien d'autre.

Pas de per-seat. Pas de per-environment. Pas de gatekeeping par palier de support.

Tous les paliers payants incluent les mêmes 100 000 pages et les mêmes limites de rendu. Ils ne diffèrent que par la personnalisation des métadonnées, la disponibilité des profils PDF/A et le tarif de dépassement.

Essai gratuit

/free
$0 à vie

100 pages / jour · s'arrête au quota.

  • +100 pages / jour · réinitialisation auto
  • +Playground + évaluation API
  • +Aucune carte requise
  • +Support email · SLA 1 jour ouvré
Essayer le Playground

Basic

/basic
$5 / mois

100 000 pages / mois inclus.

  • +100 000 pages / mois inclus
  • +Dépassement $0.00005 par page
  • +Métadonnées PDF standard · non personnalisables
  • +PDF standard uniquement · pas de profils PDF/A
  • +Support email · SLA 1 jour ouvré
S'abonner

Pro

/pro
$8 / mois

100 000 pages / mois inclus. Métadonnées personnalisables.

  • +100 000 pages / mois inclus
  • +Dépassement $0.00008 par page
  • +Titre · sujet · créateur personnalisables
  • +PDF standard uniquement · pas de profils PDF/A
  • +Support email · SLA 1 jour ouvré
S'abonner

Enterprise

/ent
$12 / mois

100 000 pages / mois inclus. PDF/A + métadonnées complètes.

  • +100 000 pages / mois inclus
  • +Dépassement $0.00012 par page
  • +Les 6 champs de métadonnées entièrement personnalisables
  • +PDF/A-1b · 2b · 3b · 4 activés
  • +Support email · SLA 1 jour ouvré
S'abonner
Déploiement privé

Besoin d'exécuter gPdf dans votre propre périmètre ?

Pour les équipes réglementées, les déploiements cloud privé/VPC et les intranets isolés. gPdf peut fonctionner comme déploiement dédié Worker, serveur ou adossé à une passerelle ; contrôles réseau, exigences de région, clauses DPA et escalade support sont cadrés par engagement.

  • +Cloud privé, VPC ou réseau isolé
  • +Déploiement dédié Worker/serveur
  • +Clauses DPA et contrôles de résidence
  • +Modèle de support cadré en amont
Contact pour déploiement privé · soon
FAQ

Les questions que les développeurs posent vraiment.

Douze réponses — citées textuellement par le JSON-LD FAQPage que les Google rich results consomment.

/01

À quelle vitesse gPdf rend-il un PDF ?

Le p50 est de 3 ms et le p99 de 8 ms — mesurés sur 1000 appels pour une seule page A4. Le temps total en périphérie, réseau inclus, est typiquement de 8 à 15 ms.

/02

Quel format d'entrée l'API accepte-t-elle ?

Un corps DocumentRequest en JSON. Pages, éléments, calques, filigranes, en-têtes, pieds de page et tableaux sont tous exprimés de manière structurelle — pas de HTML, pas de Markdown, pas de passe de mise en page navigateur.

/03

Comment gPdf se compare-t-il à Puppeteer ou Chrome headless ?

Chromium headless tourne à 200 à 800 ms par rendu et nécessite un conteneur de 800 Mo. gPdf rend la même page A4 en 3 ms dans un isolate V8 de 1 Mo, sans démarrage à froid. Le compromis est le format d'entrée : gPdf prend un DocumentRequest JSON, pas du HTML brut.

/04

Quels sont les endpoints de l'API gPdf ?

Trois : /api/v1/pdf/render prend un DocumentRequest complet pour un contrôle au pixel près. /api/v1/template-render prend template_id plus un tableau de données pour les systèmes avec un template publié. /api/v1/e-invoice/render produit des factures hybrides Factur-X / ZUGFeRD (PDF/A-3 + XML intégré). Les trois partagent le même moteur, les mêmes limites de débit et la même surface de codes d'erreur.

/05

Dois-je installer des polices sur mon serveur pour le chinois, le japonais ou le coréen ?

Non. NotoSans CJK est intégré, et une chaîne de repli automatique gère les glyphes manquants. Vous ne verrez jamais de carrés tofu, et vous n'avez pas besoin d'apt install fonts-noto-cjk sur votre runtime.

/06

Quels codes-barres puis-je rendre ?

Plus de 30 symbologies dont QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode et Code 128. Tous vectoriels. La longueur totale du code-barres est précise à 0,1 mm près de la taille demandée — assez serré pour les largeurs d'étiquettes spécifiées GS1 et ITF-14.

/07

gPdf produit-il une sortie PDF/A ou conforme aux factures électroniques ?

Oui. PDF/A-1b, 2b, 3b et 4 sont sélectionnables par requête. Les flux d'attachement Factur-X et ZUGFeRD sont pris en charge pour les scénarios de facturation électronique.

/08

gPdf peut-il produire des factures Factur-X, ZUGFeRD ou EN 16931 ?

Oui. Réglez settings.profile sur pdfa-3b et attachez la charge XML structurée comme flux de fichier. Factur-X et ZUGFeRD reposent sur PDF/A-3 — requis pour le mandat français de facturation électronique B2B à partir de septembre 2026, et le mandat allemand déjà en vigueur.

/09

Où s'exécute réellement gPdf ?

Dans des isolates V8 Cloudflare Workers. Pas de conteneur Chromium, pas de réchauffement Lambda, et pas de persistance de document après la requête.

/10

gPdf stocke-t-il mes PDF ou mes données d'entrée ?

Non. Le moteur de rendu est sans état. Votre DocumentRequest vit dans un isolate V8 pendant les quelques millisecondes du rendu, puis disparaît. gPdf n'a ni couche de cache ni stockage de documents — l'absence d'état est le contrat, pas une option.

/11

Y a-t-il un palier gratuit ?

Oui. La version d'essai gratuite offre 100 pages par jour, sans carte bancaire. Elle se réinitialise quotidiennement et s'arrête au quota — aucune facture surprise. Les paliers payants commencent à 5 $ par mois pour 100 000 pages.

/12

Comment commencer à utiliser gPdf ?

Ouvrez le playground ci-dessus, modifiez le DocumentRequest, puis cliquez sur Générer le PDF — le worker edge en direct renvoie un vrai PDF. Copiez l'extrait curl dans votre terminal pour l'appeler depuis n'importe où. Le playground ne nécessite ni installation ni carte bancaire ; un compte n'est requis que pour émettre votre propre clé API.

Du blog

Essais d'ingénierie, frais.

Voir tous les articles
  1. Choisir une API PDF en 2026 : 8 questions à poser

    Un cadre neutre pour choisir une API de génération PDF. Huit questions qui indiquent si vous serez encore satisfait dans 12 mois.

  2. gPdf vs DocRaptor : pourquoi le rendu en périphérie bat le HTML-vers-PDF

    DocRaptor utilise Prince pour convertir du HTML en PDF sur un backend hébergé. gPdf rend du JSON structuré directement à la périphérie Cloudflare. L'écart de prix est de 18×. Voici pourquoi ce n'est pas un appât.

  3. PDF/A et Factur-X expliqués aux ingénieurs (sans le jargon juridique)

    Ce que les profils PDF/A contraignent réellement, pourquoi Factur-X devient obligatoire en France à partir de septembre 2026, et le plus petit pipeline pratique pour devenir conforme depuis un moteur de rendu JSON.

Confiance

Conformité et résidence des données

Ingénierie auditable plus la paperasse — les deux registres, les deux vérifiables.

SOC2

SOC 2 Type II

Audit prévu Q3 2026 · preuve sur demande.

GDPR

RGPD + DPA

Clauses contractuelles types disponibles sur demande.

REGION

Résidence des données

Options de résidence EU, US, APAC et SA. Les exigences de région sont cadrées par contrat.

STATELESS

Sans état par défaut

Pas de persistance de document. Aucune couche de cache ni stockage de documents dans le produit.

BENCHED

Benchmarks publics

Concurrents nommés, méthodologie complète, date d'échantillon. Chaque benchmark de cette page est reproductible — refaites-le sur votre charge avant décision.

DETERMINISTIC

Déterministe

Même entrée → PDF byte-identique. Diffable. Testable en CI sans dérive de snapshot.