PDF Tools API

网页转 PDF API

Q: 网页转 PDF API 怎么计费？

成功的 网页转 PDF API 请求会消耗 API Credits；失败处理会自动退回。每个登录用户每月有 100 个免费 API Credits，1,000 Credits = $1。

在后端、批处理或产品流程中把网页转成 PDF，不必自己维护 PDF 处理基础设施；成功请求按 Credits 计费。

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/webpage-to-pdf/pdf

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

Use case

适合定时保存公开网页、客户页面导出或在线证据留存。网页工具用于人工处理，API 用于稳定的服务端自动化。

cURL example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/report",
    "pageSize": "A4",
    "waitDelay": 2
  }' \
  --output webpage.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/webpage-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  url: 'https://example.com/report',
  pageSize: 'A4',
  waitDelay: 2
})
});

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

await writeFile('webpage.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/webpage-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'url': 'https://example.com/report',
        'pageSize': 'A4',
        'waitDelay': 2,
    },
)
response.raise_for_status()

with open('webpage.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

webpage.pdf，响应头会返回本次消耗的 Credits 和剩余额度。

Content-Type: 生成文件的 MIME 类型，通常是 application/pdf 或 application/zip。
Content-Disposition: 生成文件的下载文件名。
X-Credits-Charged: 成功请求实际扣除的 Credits。
X-Credit-Balance: 请求完成后的剩余 API Credits。

FAQ