支持HTML、CSS和URL

将HTML转换为PDF 完整CSS支持

将任意HTML内容转换为像素级精确的PDF。支持自定义CSS、Google字体、页眉页脚和页面配置。支持发送原始HTML、上传文件或提供URL。

# Convert HTML to PDF
curl -X POST \
  https://api.convertfilefast.com/v2/convert/html-to-pdf \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "<html><body><h1>Invoice #1234</h1><p>Total: $99.00</p></body></html>",
    "css": "body { font-family: Inter, sans-serif; }",
    "options": {"page_size": "A4", "orientation": "portrait"}
}' \
  --output invoice.pdf

# HTTP 200 OK — Content-Type: application/pdf
2秒内转换完成

优势

为什么使用我们的API?

完整可靠的解决方案,适用于任何技术栈的集成。

完整CSS支持

精确渲染CSS3、Flexbox、Grid、Google字体和自定义样式表。

多种输入方式

发送原始HTML字符串、上传.html文件或提供公共URL进行转换。

自定义页面设置

按请求配置页面大小(A4、Letter、A3)、方向和边距。

页眉和页脚

使用CSS Paged Media在每页添加重复的页眉和页脚。

Base64图片嵌入

将Logo和图片嵌入为base64数据URI,确保可靠渲染。

生产就绪

99.9%正常运行时间,亚秒转换,自动扩展基础设施。

如何使用

完成此转换的 4 个步骤

  1. 1

    创建 API 密钥

    在 convertfilefast.com/signup 注册,并从控制台复制以 cff_ 开头的 API 密钥。免费套餐包含每月 10 次转换。

  2. 2

    将 HTML 通过 POST 发送到接口

    向 https://api.convertfilefast.com/v2/convert/html-to-pdf 发送 JSON POST 请求,携带请求头 X-API-Key: cff_your_key,请求体包含 content(你的 HTML)、可选的 css 字符串,以及用于设置 page_size、orientation 和 margins 的 options 对象。

  3. 3

    接收 PDF 文件

    响应体即渲染好的 PDF,会带上正确的 Content-Disposition 文件名进行流式返回。可以保存到磁盘,或传递给流程的下一步。

  4. 4

    或通过 MCP 供 AI 智能体调用

    在 Claude、Cursor 或任意兼容 MCP 的客户端中添加地址为 https://mcp.convertfilefast.com/mcp 的 MCP 服务器,然后只需调用一次 convert_file({ source_format: 'html', target_format: 'pdf', source_url: '...' }) 工具,无需任何 HTTP 客户端。

面向 AI 智能体

也可以从 Claude、Cursor 或任意 MCP 客户端调用

Convert File Fast 提供原生的 Model Context Protocol 服务器。只需一次工具调用,即可把该转换交给 AI 智能体完成 —— 无需 HTTP 客户端,无需处理二进制,并为每个用户单独签发 API 密钥。

本地安装
npx -y convertfilefast-mcp
MCP 工具调用
convert_file({ target_format: "pdf", source_url: "https://example.com/file.html" })

FAQ

常见问题

是否支持 Flexbox、Grid 等现代 CSS?

支持。转换引擎是 WeasyPrint,一个专门的 CSS 转 PDF 渲染器,支持包含 Flexbox 和 Grid 在内的 CSS3,以及用于设置页面大小、方向和边距的 @page 规则 —— 通过 options 对象中的 page_size、orientation 和 margin 字段配置。

会渲染 JavaScript 或单页应用吗?

不会。WeasyPrint 没有 JavaScript 引擎,因此客户端渲染的内容(React/Vue 应用、页面加载后注入的内容)不会出现在 PDF 中。请发送已完全渲染好的静态 HTML —— 服务端渲染的页面或预渲染的快照都可以正常使用。

如何从 Claude、Cursor 等 AI 智能体中调用?

在客户端中添加 ConvertFileFast 的 MCP 服务器,地址为 https://mcp.convertfilefast.com/mcp,并配置你的 API key。智能体随后只需调用一次 convert_file({ source_format: 'html', target_format: 'pdf', source_url: '...' }) 工具,无需处理 HTTP 请求或二进制数据。

我提交的 HTML 内容会保存在你们的服务器上吗?

不会。内容在内存中处理,PDF 返回后立即丢弃。没有持久化存储,不用于训练,也不会与第三方共享。

HTML 内容的最大大小是多少?

此接口对发送的 HTML 和 CSS 总大小设有单独的上限,与你所在套餐的文件大小限制无关 —— 这里没有文件上传,只有请求体中的内容。超过该上限的请求会被拒绝并返回 400 错误,错误信息中会注明当前的上限值。如果要生成大型文档,请拆分为多次调用,或精简内嵌资源。

费用是如何计算的?

每次转换计为月度配额中的一个单位。免费套餐每月包含 10 次转换。预付费积分包起价为 $4/1,000 次转换(每次 $0.004)。订阅套餐起价为 $9/月,包含 5,000 次转换。

开始将HTML转换为PDF

获取API密钥,在一分钟内转换您的第一个HTML文档。免费计划每月包含10次转换。

无需信用卡。Free计划10次免费转换。