PDF工具API

PDF文件的合并、拆分、压缩、转换、保护和操作端点。所有端点接受multipart/form-data并以二进制下载返回处理后的文件。

PDF合并

POST/api/pdf-merge

将多个PDF文件合并为一个PDF文档。文件按上传顺序合并。

Parameters

Name	Type	Required	Description
`files`	File[]	Required	要合并的多个PDF文件

Response:合并后的PDF文件

bash

curl -X POST https://freefiletools.io/api/pdf-merge \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

PDF拆分

POST/api/pdf-split

根据页面范围将PDF文件拆分为多个部分。返回包含拆分后PDF的ZIP文件。

Parameters

Name	Type	Required	Description
`file`	File	Required	要拆分的PDF文件
`ranges`	string	Required	页面范围，例如："1-3,5,7-9"。每个范围生成一个单独的PDF。

Response:包含拆分后PDF的ZIP文件

bash

curl -X POST https://freefiletools.io/api/pdf-split \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "ranges=1-3,5,7-9" \
  -o split-pages.zip

PDF压缩

POST/api/pdf-compress

压缩PDF文件以减小其大小。使用Ghostscript进行高质量压缩。

Parameters

Name	Type	Required	Description
`file`	File	Required	要压缩的PDF文件
`level`	string	Optional	压缩级别："low"、"medium"或"high"。默认："medium"

Response:压缩后的PDF文件

bash

curl -X POST https://freefiletools.io/api/pdf-compress \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "level=high" \
  -o compressed.pdf

PDF转Word

POST/api/pdf-to-word

将PDF文件转换为Microsoft Word（.docx）文档。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的PDF文件

Response:DOCX文件

bash

curl -X POST https://freefiletools.io/api/pdf-to-word \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.docx

PDF转图像

POST/api/pdf-to-image

将PDF页面转换为图像。返回包含每页一张图像的ZIP文件。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的PDF文件
`format`	string	Optional	图像格式："png"、"jpg"或"webp"。默认："png"
`dpi`	number	Optional	分辨率（DPI）。默认：150

Response:包含图像的ZIP文件

bash

curl -X POST https://freefiletools.io/api/pdf-to-image \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "format=png" \
  -F "dpi=300" \
  -o pages.zip

PDF转Excel

POST/api/pdf-to-excel

将PDF文件转换为Microsoft Excel（.xlsx）电子表格。对于包含表格数据的PDF效果最佳。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的PDF文件

Response:XLSX文件

bash

curl -X POST https://freefiletools.io/api/pdf-to-excel \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.xlsx

PDF转PowerPoint

POST/api/pdf-to-ppt

将PDF文件转换为Microsoft PowerPoint（.pptx）演示文稿。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的PDF文件

Response:PPTX文件

bash

curl -X POST https://freefiletools.io/api/pdf-to-ppt \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o presentation.pptx

Word转PDF

POST/api/word-to-pdf

将Microsoft Word（.docx）文档转换为PDF。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的.docx文件

Response:PDF文件

bash

curl -X POST https://freefiletools.io/api/word-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.pdf

PowerPoint转PDF

POST/api/ppt-to-pdf

将Microsoft PowerPoint（.pptx）演示文稿转换为PDF。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的.pptx文件

Response:PDF文件

bash

curl -X POST https://freefiletools.io/api/ppt-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o presentation.pdf

Excel转PDF

POST/api/excel-to-pdf

将Microsoft Excel（.xlsx）电子表格转换为PDF。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的.xlsx文件

Response:PDF文件

bash

curl -X POST https://freefiletools.io/api/excel-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o spreadsheet.pdf

保护PDF

POST/api/protect-pdf

为PDF文件设置密码保护。生成的PDF需要密码才能打开。

Parameters

Name	Type	Required	Description
`file`	File	Required	要保护的PDF文件
`password`	string	Required	要设置的PDF密码

Response:受密码保护的PDF文件

bash

curl -X POST https://freefiletools.io/api/protect-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "password=mysecretpassword" \
  -o protected.pdf

解锁PDF

POST/api/unlock-pdf

移除PDF文件的密码保护。需要当前密码。

Parameters

Name	Type	Required	Description
`file`	File	Required	受密码保护的PDF文件
`password`	string	Required	PDF的当前密码

Response:已解锁的PDF文件

bash

curl -X POST https://freefiletools.io/api/unlock-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "password=mysecretpassword" \
  -o unlocked.pdf

旋转PDF

POST/api/rotate-pdf

将PDF文件的所有页面旋转指定角度。

Parameters

Name	Type	Required	Description
`file`	File	Required	要旋转的PDF文件
`angle`	number	Required	旋转角度：90、180或270度

Response:旋转后的PDF文件

bash

curl -X POST https://freefiletools.io/api/rotate-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "angle=90" \
  -o rotated.pdf

PDF水印

POST/api/watermark-pdf

为PDF文件的所有页面添加文字水印。

Parameters

Name	Type	Required	Description
`file`	File	Required	要添加水印的PDF文件
`text`	string	Required	要添加的水印文本

Response:添加水印后的PDF文件

bash

curl -X POST https://freefiletools.io/api/watermark-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "text=CONFIDENTIAL" \
  -o watermarked.pdf

OCR PDF

POST/api/ocr-pdf

对扫描的PDF应用光学字符识别（OCR），使文本可选择和可搜索。使用Tesseract OCR引擎。

Parameters

Name	Type	Required	Description
`file`	File	Required	扫描的PDF文件
`language`	string	Optional	OCR语言："eng"（英语）、"tur"（土耳其语）、"deu"（德语）等。默认："eng"

Response:可搜索的PDF文件

bash

curl -X POST https://freefiletools.io/api/ocr-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "language=eng" \
  -o searchable.pdf

修复PDF

POST/api/repair-pdf

尝试修复损坏的PDF文件。

Parameters

Name	Type	Required	Description
`file`	File	Required	损坏的PDF文件

Response:修复后的PDF文件

bash

curl -X POST https://freefiletools.io/api/repair-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o repaired.pdf

裁剪PDF

POST/api/crop-pdf

裁剪PDF文件的所有页面，移除空白或裁剪到特定区域。

Parameters

Name	Type	Required	Description
`file`	File	Required	要裁剪的PDF文件

Response:裁剪后的PDF文件

bash

curl -X POST https://freefiletools.io/api/crop-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o cropped.pdf

添加页码

POST/api/page-numbers

为PDF文件的所有页面添加页码。

Parameters

Name	Type	Required	Description
`file`	File	Required	PDF文件

Response:带页码的PDF文件

bash

curl -X POST https://freefiletools.io/api/page-numbers \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o numbered.pdf

图像转PDF

POST/api/img-to-pdf

将一张或多张图像转换为PDF文件。每张图像成为一页。

Parameters

Name	Type	Required	Description
`files`	File[]	Required	图像文件（JPG、PNG、WebP）

Response:PDF文件

bash

curl -X POST https://freefiletools.io/api/img-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o images.pdf

PDF转PDF/A

POST/api/pdf-to-pdfa

将PDF文件转换为PDF/A格式以进行长期归档。使用Ghostscript进行转换。

Parameters

Name	Type	Required	Description
`file`	File	Required	要转换的PDF文件

Response:PDF/A文件

bash

curl -X POST https://freefiletools.io/api/pdf-to-pdfa \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document-pdfa.pdf