# Compress a PDF file
curl -X POST \
https://api.convertfilefast.com/v2/pdf/compress \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@document.pdf" \
-F "quality=medium" \
-F "remove_metadata=true" \
-D headers.txt \
--output compressed.pdf
# HTTP 200 OK — Headers include compression stats:
# X-Original-Size, X-Compressed-Size, X-Compression-Ratioimport requests
response = requests.post(
"https://api.convertfilefast.com/v2/pdf/compress",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"file": open("document.pdf", "rb")},
data={"quality": "medium", "remove_metadata": "true"}
)
# Read compression stats from response headers
original_size = response.headers.get("X-Original-Size")
compressed_size = response.headers.get("X-Compressed-Size")
compression_ratio = response.headers.get("X-Compression-Ratio")
print(f"Original: {original_size} bytes")
print(f"Compressed: {compressed_size} bytes")
print(f"Ratio: {compression_ratio}%")
with open("compressed.pdf", "wb") as f:
f.write(response.content)const formData = new FormData();
formData.append("file", fs.createReadStream("document.pdf"));
formData.append("quality", "medium");
formData.append("remove_metadata", "true");
const response = await fetch(
"https://api.convertfilefast.com/v2/pdf/compress",
{
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY" },
body: formData,
}
);
// Read compression stats from headers
console.log("Ratio:", response.headers.get("x-compression-ratio"));
fs.writeFileSync("compressed.pdf", Buffer.from(await response.arrayBuffer()));// n8n HTTP Request Node
{
"method": "POST",
"url": "https://api.convertfilefast.com/v2/pdf/compress",
"contentType": "multipart-form-data",
"bodyParameters": {
"parameters": [
{ "name": "file", "parameterType": "formBinaryData", "inputDataFieldName": "data" },
{ "name": "quality", "value": "medium" },
{ "name": "remove_metadata", "value": "true" }
]
},
"options": { "response": { "responseFormat": "file" } }
}优势
为什么使用我们的API?
完整可靠的解决方案,适用于任何技术栈的集成。
质量级别
从低、中、高质量级别中选择,以平衡文件大小减小与输出质量。
压缩统计
响应头包含每个请求的X-Original-Size、X-Compressed-Size和X-Compression-Ratio。
元数据删除
可选择删除PDF元数据(作者、创建日期、软件)以进一步减小文件大小。
显著减小
在保持可接受视觉质量的同时,对图像密集型PDF实现高达70%的大小减小。
自动化就绪
使用n8n集成到文件上传管道、存储工作流或电子邮件附件处理器中。
零存储
PDF在内存中压缩,处理后立即删除。完整的隐私保证。
也可以从 Claude、Cursor 或任意 MCP 客户端调用
Convert File Fast 提供原生的 Model Context Protocol 服务器。只需一次工具调用,即可把该转换交给 AI 智能体完成 —— 无需 HTTP 客户端,无需处理二进制,并为每个用户单独签发 API 密钥。
npx -y convertfilefast-mcpcompress_pdf({ source_url: "https://example.com/doc.pdf", quality: "medium" })FAQ
常见问题
压缩 PDF 时有哪些质量级别可选?
通过 `quality` 字段可选择 `low`、`medium`、`high` 三个级别。`low` 生成体积最小的文件,适合归档或邮件附件;`medium` 是均衡的默认值;`high` 让图像更接近原稿,压缩幅度相对温和。
这个 API 能把 PDF 文件缩小多少?
图像较多的 PDF 通常可缩小最多 70%。每次响应都会在头部返回准确数值——`X-Original-Size`、`X-Compressed-Size` 和 `X-Compression-Ratio`——让你的流程可以核对结果,而不是凭估算。
可以在压缩的同时移除 PDF 元数据吗?
可以。发送 `remove_metadata=true`,API 会在返回文件前移除作者、创建日期和生成软件等字段。这既能再减少一点体积,也能避免在对外发布的文档中泄露内部信息。
支持的最大文件大小是多少?
上限取决于你的套餐,并按 API 密钥生效 —— 当前接受的上限可在 https://api.convertfilefast.com/v1/info 查询,你自己套餐的上限显示在控制台中。 文件在内存中处理,响应发送后立即删除 —— 我们的服务器不保存任何内容。