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