/01
gPdf は PDF をどのくらい速く描画できますか？
1000 回の呼び出しでの計測で、A4 1 ページの p50 は 3 ms、p99 は 8 ms です。ネットワークを含むエッジ全体の所要時間は通常 8-15 ms です。
FAQ
開発者が実際に尋ねる質問。
12 の回答 — Google のリッチリザルトで使われる JSON-LD FAQPage と同じ内容です。
/02
API はどの入力形式を受け付けますか？
JSON DocumentRequest ボディです。ページ、要素、レイヤー、透かし、ヘッダー、フッター、テーブルはすべて構造的に表現されます — HTML、Markdown、ブラウザのレイアウトパスは一切ありません。
/03
gPdf は Puppeteer や headless Chrome と比較してどうですか？
headless Chromium は描画あたり 200〜800 ms かかり、800 MB のコンテナを必要とします。gPdf は同じ A4 ページを 1 MB の V8 isolate 内で 3 ms で描画し、コールドスタートはありません。トレードオフは入力形式です: gPdf は JSON DocumentRequest を受け取り、生の HTML は受け取りません。
/04
gPdf API のエンドポイントは何ですか？
3 つ: /api/v1/pdf/render はピクセルレベル制御のために完全な DocumentRequest を受け取ります。/api/v1/template-render は公開済みテンプレートを持つシステム向けに template_id とデータ配列を受け取ります。/api/v1/e-invoice/render は Factur-X / ZUGFeRD ハイブリッドインボイス（PDF/A-3 + 埋め込み XML）を生成します。3 つはすべて同じエンジン、同じレート制限、同じエラーコード体系を共有します。
/05
中国語、日本語、韓国語のためにサーバーにフォントをインストールする必要がありますか？
いいえ。NotoSans CJK が組み込まれており、自動フォントフォールバックチェーンが欠落グリフを処理します。豆腐ボックスを見ることはなく、ランタイムで apt install fonts-noto-cjk は不要です。
/06
どのバーコードを描画できますか？
QR、GS1-128、PDF417、DataMatrix、Aztec、MaxiCode、Code 128 を含む 30 以上のシンボロジー。すべてベクター。バーコード全長は要求サイズの 0.1 mm 以内に収まります — GS1 / ITF-14 仕様のラベル幅に十分な精度です。
/07
gPdf は PDF/A や電子インボイス準拠の出力を生成しますか？
はい。リクエストごとに PDF/A-1b、2b、3b、4 を選択できます。電子インボイスシナリオ向けに Factur-X と ZUGFeRD の添付ストリームに対応します。
/08
gPdf は Factur-X、ZUGFeRD、EN 16931 電子インボイスを生成できますか？
はい。settings.profile を pdfa-3b に設定し、構造化 XML ペイロードをファイルストリームとして添付します。Factur-X と ZUGFeRD は PDF/A-3 上で動作し、すでに有効なドイツの電子インボイス義務化と、2026 年 9 月からのフランスの B2B 義務化に必要です。
/09
gPdf は実際にはどこで動作しますか？
Cloudflare Workers の V8 isolate 内で動作します。Chromium コンテナなし、Lambda ウォーミングなし、リクエスト後のドキュメント永続化なし。
/10
gPdf は私の PDF や入力データを保存しますか？
いいえ。レンダラーはステートレスです。あなたの DocumentRequest は描画の数ミリ秒間 V8 isolate に存在し、その後消えます。gPdf にはキャッシング層もドキュメントストアもありません — ステートレスは契約であり、オプトインのトグルではありません。
/11
無料プランはありますか？
はい。Free Trial は 1 日 100 ページ、クレジットカード不要です。毎日自動リセットされ、クォータで停止します — 予期しない請求はありません。有料プランは月 100,000 ページで $5 から。
/12
gPdf を使い始めるには？
上のプレイグラウンドを開き、DocumentRequest を編集して「PDFを生成」を押す — ライブエッジワーカーが本物の PDF を返します。curl スニペットをターミナルにコピーすればどこからでも呼び出せます。プレイグラウンドはインストールもクレジットカードも不要です。アカウントは独自の API キーを発行する場合のみ必要です。