PDF Tools API

HTML 轉 PDF API

把把 HTML 轉成 PDF接進後端、批次任務或產品流程，不需要自行維護 PDF 處理服務。

Create API Key Read full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/html-to-pdf/pdf

Use your API Key in the x-api-key header.

Use case

適合在伺服器端把報表、收據、對帳單或內部頁面渲染為 PDF。網站工具適合人工確認，API 適合穩定重複的伺服器端流程。

cURL example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "html": "<!doctype html><html><body><h1>Report</h1></body></html>",
    "pageSize": "A4",
    "printBackground": true
  }' \
  --output html-to-pdf.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/html-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  html: '<!doctype html><html><body><h1>Report</h1></body></html>',
  pageSize: 'A4',
  printBackground: true
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('html-to-pdf.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/html-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'html': '<!doctype html><html><body><h1>Report</h1></body></html>',
        'pageSize': 'A4',
        'printBackground': True,
    },
)
response.raise_for_status()

with open('html-to-pdf.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_payload

JSON 或 multipart 請求缺少必要的 HTML、URL 或檔案輸入。

401invalid_api_key

x-api-key 缺少、無效或已輪換。

402insufficient_credits

帳號 API Credits 不足。

502conversion_failed

伺服器端渲染沒有完成轉換；失敗處理會自動退回 Credits。

Limits

需要可正常開啟的 PDF 或有效輸入資料。
請從伺服器端呼叫 API，避免在瀏覽器暴露 API Key。
大量處理前先用代表性樣本確認輸出品質。

Response headers

html-to-pdf.pdf，回應標頭會列出本次扣除的 Credits 與剩餘額度。

Content-Type: 產出檔案的 MIME 類型，通常是 application/pdf 或 application/zip。
Content-Disposition: 產出檔案的下載檔名。
X-Credits-Charged: 成功請求扣除的 Credits。
X-Credit-Balance: 請求完成後剩餘的 API Credits。

FAQ

HTML 轉 PDF API 如何計費？

成功的 HTML 轉 PDF API 請求會使用 API Credits；處理失敗會自動退回。每位登入使用者每月有 100 個免費 API Credits，1,000 Credits = $1。

網站工具會使用 API Credits 嗎？

瀏覽器本地處理的網站工具不使用 API Credits；只有帶 API Key 的自動化請求才計費。

可以從前端直接呼叫嗎？

不建議。API Key 應保存在伺服器端、排程任務或後端自動化腳本中。

Start with 100 free API Credits

Create an API Key, test HTML 轉 PDF API, and buy more Credits only when automation volume grows.

Get API Key View full API docs