将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/pdfimport requests
response = requests.post(
"https://api.convertfilefast.com/v2/convert/html-to-pdf",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"content": "<h1>Invoice #1234</h1>",
"css": "body { font-family: Inter, sans-serif; }",
"options": {"page_size": "A4"}
}
)
with open("invoice.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://api.convertfilefast.com/v2/convert/html-to-pdf",
{
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
content: "<h1>Invoice #1234</h1>",
css: "body { font-family: Inter, sans-serif; }",
options: { page_size: "A4" }
}),
}
);
const pdf = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("invoice.pdf", pdf);// n8n HTTP Request Node
{
"method": "POST",
"url": "https://api.convertfilefast.com/v2/convert/html-to-pdf",
"contentType": "json",
"body": "={{ JSON.stringify({ content: $json.html_content, css: 'body { font-family: sans-serif; }', options: { page_size: 'A4' } }) }}",
"options": { "response": { "responseFormat": "file" } }
}优势
为什么使用我们的API?
完整可靠的解决方案,适用于任何技术栈的集成。
完整CSS支持
精确渲染CSS3、Flexbox、Grid、Google字体和自定义样式表。
多种输入方式
发送原始HTML字符串、上传.html文件或提供公共URL进行转换。
自定义页面设置
按请求配置页面大小(A4、Letter、A3)、方向和边距。
页眉和页脚
使用CSS Paged Media在每页添加重复的页眉和页脚。
Base64图片嵌入
将Logo和图片嵌入为base64数据URI,确保可靠渲染。
生产就绪
99.9%正常运行时间,亚秒转换,自动扩展基础设施。
如何使用
完成此转换的 4 个步骤
- 1
创建 API 密钥
在 convertfilefast.com/signup 注册,并从控制台复制以 cff_ 开头的 API 密钥。免费套餐包含每月 10 次转换。
- 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
接收 PDF 文件
响应体即渲染好的 PDF,会带上正确的 Content-Disposition 文件名进行流式返回。可以保存到磁盘,或传递给流程的下一步。
- 4
或通过 MCP 供 AI 智能体调用
在 Claude、Cursor 或任意兼容 MCP 的客户端中添加地址为 https://mcp.convertfilefast.com/mcp 的 MCP 服务器,然后只需调用一次 convert_file({ source_format: 'html', target_format: 'pdf', source_url: '...' }) 工具,无需任何 HTTP 客户端。
也可以从 Claude、Cursor 或任意 MCP 客户端调用
Convert File Fast 提供原生的 Model Context Protocol 服务器。只需一次工具调用,即可把该转换交给 AI 智能体完成 —— 无需 HTTP 客户端,无需处理二进制,并为每个用户单独签发 API 密钥。
npx -y convertfilefast-mcpconvert_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 次转换。