Files
SnapOtter/apps/docs/pl/tools/pdf/compress-pdf.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.1 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Zmniejsz rozmiar pliku PDF przez kompresję osadzonych obrazów. a8bb0baaca25 human 4ad39b458a2f

Compress PDF

Zmniejsz rozmiar pliku PDF przez zmniejszenie rozdzielczości osadzonych obrazów. Wybierz suwak jakości albo docelowy rozmiar pliku.

API Endpoint

POST /api/v1/tools/pdf/compress-pdf

Przyjmuje dane formularza multipart z plikiem PDF oraz polem JSON settings.

Parameters

Parameter Type Required Default Description
mode string No "quality" Tryb kompresji: quality lub targetSize
quality integer No 75 Jakość kompresji, 1-100 (wyższa = mniejsza kompresja). Używane w trybie quality
targetSizeKb number No - Docelowy rozmiar pliku w kilobajtach. Używane w trybie targetSize

Example Request

Kompresja według jakości:

curl -X POST http://localhost:1349/api/v1/tools/pdf/compress-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@document.pdf" \
  -F 'settings={"mode": "quality", "quality": 60}'

Kompresja do docelowego rozmiaru:

curl -X POST http://localhost:1349/api/v1/tools/pdf/compress-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@document.pdf" \
  -F 'settings={"mode": "targetSize", "targetSizeKb": 500}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
  "originalSize": 5200000,
  "processedSize": 1800000
}

Notes

  • W trybie quality niższe wartości dają mniejsze pliki z większą degradacją obrazu.
  • W trybie targetSize wyszukiwanie binarne znajduje najwyższe DPI mieszczące się w żądanym rozmiarze.
  • Jeśli kompresja miałaby powiększyć plik, zwracane są niezmienione oryginalne bajty.
  • Treść tekstowa i wektorowa nie jest zmieniana; zmniejszana jest tylko rozdzielczość osadzonych obrazów rastrowych.