PDF 生成 API v1 — ステートレス

PDF生成API
ビジネステンプレートから

HTML、DOCX、Markdown、または JSON テンプレートから PDF を生成します。データ保持ゼロ — 文書やデータは保存されません。

API キーを取得するクイックスタートガイド

4つの入力フォーマット

変数置換

ゼロデータストレージ

99.9% の稼働時間 SLA

クイックスタート

最初の PDF は 2 分以内に入手できます。 API キーを作成し、リクエストを送信し、結果をダウンロードします。

API キーを取得する

以下のコンソールまたはダッシュボードから API キーを作成します。

API キーは秘密です。フロントエンドコードでは決して公開しないでください。

最初のリクエストを送信します

PDF を生成するには、次の cURL コマンドを使用します。

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

PDFをダウンロード

API は、応答本文で PDF バイナリを直接返します。

生成された PDF は、--output フラグで指定されたファイルに保存されます。

ライブデモ

ここで API を試してみてください。コンテンツと変数を編集し、[生成] をクリックすると PDF がすぐに表示されます。

サインインしてデモを試す

無料のアカウントを作成してライブプレイグラウンドにアクセスし、最大 5 つのデモ PDF を生成します。

アカウントを作成するサインイン

APIコンソール

API キーを管理し、このページから直接使用状況を監視します。

サインインが必要です

API キーを作成および管理するには、サインインしてください。

アカウントを作成するサインイン

認証

すべての API リクエストには、X-API-Key ヘッダーを介して送信される API キーが必要です。

仕組み

コンソールまたはダッシュボードから API キーを作成します。
これをすべてのリクエストに X-API-Key ヘッダーとして含めます。
API はキーを検証し、クォータをチェックします。
無効なキーまたは取り消されたキーは 401 エラーを返します。

API キーを安全に保管してください。環境変数を使用し、ソースコードにハードコーディングしないでください。

リクエスト例

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

無効なキー応答 (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

入力フォーマット

EasyPDF は 4 つの入力形式をサポートしています。ワークフローに最適なものを選択してください。

HTML

完全な CSS サポート、Chromium 経由でピクセルパーフェクト

DOCX

可変プレースホルダーを含む Word テンプレートをアップロードする

Markdown

美しいドキュメントのための 5 つの組み込みテーマ

Template JSON

正確なレイアウト制御のためのキャンバスエンジン

HTML→PDF

最も人気のある

インライン CSS を使用して HTML を送信します。 Chromium レンダリングエンジンは、ブラウザ表示に一致するピクセル完璧な出力を保証します。

主な特長

CSS3 の完全サポート (フレックスボックス、グリッド、メディアクエリ)
ページ番号付きのカスタムヘッダーとフッター
{{variable}} 構文による変数置換
A4/レター/リーガルページサイズのレスポンシブレイアウト

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

APIエンドポイント

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

HTML、Markdown、またはテンプレート JSON コンテンツから PDF を生成します。

Request Body (JSON)

パラメータ	タイプ	必須	説明
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	HTML または Markdown コンテンツ文字列 (html/markdown には必須)
`template_data`	`object`	Yes*	テンプレート JSON オブジェクト (テンプレート形式に必要)
`variables`	`object`	No	変数置換のためのキーと値のペア
`options`	`object`	No	PDF 生成オプション (ページ形式、余白など)

応答

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

DOCX ファイルをアップロードして、オプションの変数置換を使用して PDF に変換します。

Form Fields

Field	タイプ	必須	説明
`file`	File	Yes	変換する .docx ファイル
`variables`	string (JSON)	No	変数置換のためのキーと値のペア
`options`	string (JSON)	No	JSON 文字列としての PDF オプション

POST/generate/previewAPI Key

完全な PDF ではなく、最初のページの PNG プレビューを生成します。

200Content-Type: image/png

GET/usageAPI Key

現在の月間使用量と残りの割り当てを確認します。

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

新しい API キーを作成します (JWT 認証が必要です)。

GET/keysJWT Bearer

すべての API キーを使用状況の統計とともにリストします。

DELETE/keys/:key_idJWT Bearer

API キーを完全に取り消し (非アクティブ化) します。

コード例

好みの言語と形式で作成された、すぐに使用できる完全な例。以下から言語と入力形式を選択してください。

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

使用例

チームが EasyPDF API を使用して大規模なドキュメント生成を自動化する方法をご覧ください。

請求書と領収書

動的な品目、合計、顧客の詳細を含むブランド化された請求書を生成します。

HTML / DOCX

契約と協定

Word テンプレートにクライアントデータを入力し、署名用に PDF に変換します。

DOCX

証明書と卒業証書

正確なレイアウトと配置でパーソナライズされた証明書を作成します。

Template JSON

レポートとダッシュボード

Markdown または HTML データを洗練された PDF レポートに変換します。

Markdown / HTML

手紙と郵送物

一括メール送信用に DOCX テンプレートからパーソナライズされたレターを生成します。

DOCX

コンプライアンス文書

監査に対応した改ざん防止のコンプライアンス文書を作成します。

HTML

PDF オプション

オプションオブジェクト内のこれらのオプションのパラメーターを使用して出力をカスタマイズします。

Option	タイプ	デフォルト	説明
`page_format`	`string`	`"A4"`	ページサイズ: A4、レター、リーガル、タブロイド、またはカスタム
`landscape`	`boolean`	`false`	横向きを有効にする
`margin_top`	`string`	`"20mm"`	上マージン (CSS 単位: mm、cm、in、px)
`margin_bottom`	`string`	`"20mm"`	下マージン
`margin_left`	`string`	`"15mm"`	左マージン
`margin_right`	`string`	`"15mm"`	右マージン
`header_html`	`string`	`null`	ページヘッダーのHTMLコンテンツ
`footer_html`	`string`	`null`	ページフッターの HTML コンテンツ (pageNumber、totalPages をサポート)
`theme`	`string`	`"modern"`	Markdown テーマ: モダン、クラシック、ミニマル、Github、アカデミック

フルオプションの例

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

エラー処理

API は、一貫したエラーコードを持つ構造化された JSON エラーを返します。

エラー応答フォーマット

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	いつ	何をするか
`400`	`missing_content`	必須フィールドがありません	リクエスト本文のフィールドを確認する
`400`	`invalid_json`	JSONの解析に失敗しました	JSON ペイロードを検証する
`400`	`unsupported_format`	不明な形式の値	HTML、マークダウン、またはテンプレートを使用する
`401`	`invalid_api_key`	APIキーが見つかりません	X-API-Key ヘッダーを確認する
`402`	`quota_exceeded`	毎月の割り当てを超過しました	プランをアップグレードするか、リセットされるまで待ちます
`403`	`api_key_revoked`	キーが取り消されました	新しい API キーを作成する
`429`	`rate_limit_exceeded`	レート制限に達しました	待機して指数関数的バックオフで再試行する
`500`	`generation_failed`	内部処理エラー	コンテンツにエラーがないか確認して再試行してください

レート制限とクォータ

各プランには、毎月の PDF クォータと 1 分あたりのレート制限があります。

レート制限

レート制限を超えるリクエストは、Retry-After ヘッダーを持つ 429 レスポンスを受け取ります。

レート制限された応答

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

毎月の割り当て

使用量は毎月 1 日の午前 0 時 (UTC) にリセットされます。

Plan	PDFs/月	Rate limit	価格	超過料金
Starter	500	10/min	9€/月	0,02€/PDF
Business	5 000	30/min	79€/月	0,01€/PDF
Enterprise	カスタム	カスタム	見積もり中	交渉可能

ベストプラクティス

API を最大限に活用するには、次の推奨事項に従ってください。

動的コンテンツに変数を使用する

テンプレートを静的に保ち、変数オブジェクトを通じてデータを挿入します。これは、呼び出しごとに HTML を再構築するよりも効率的です。

エラーを適切に処理する

HTTPステータスコードを常に確認してください。 429 エラーと 5xx エラーに対して指数バックオフを使用して再試行を実装します。

テンプレートを最適化する

CSS を最小限に抑え、外部アセットを回避し (インライン化)、運用環境にデプロイする前にテンプレートをテストします。

使用状況を監視する

/usage エンドポイントまたは上記のコンソールを使用して、消費量を追跡し、予期しないクォータ制限を回避します。

API キーを保護する

キーを環境変数またはシークレットマネージャーに保存します。キーを定期的にローテーションし、未使用のキーを取り消します。

価格設定

シンプルで透明性のある価格設定。使った分だけお支払いください。

Starter

9€/月

~0,018€ / PDF

500 PDFs / 月
10 リクエスト/分
4 つの入力フォーマットすべて
PNG プレビューの生成
電子メールサポート
超過料金 : 0,02€/PDF

始めましょう

ベストバリュー

Business

79€/月

~0,016€ / PDF

5 000 PDFs / 月
30 リクエスト/分
すべてのスターター機能
優先サポート
使用状況分析ダッシュボード
超過料金 : 0,01€/PDF