Files
SnapOtter/apps/docs/es/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.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Reduce el tamaño de un archivo PDF comprimiendo las imágenes incrustadas. a8bb0baaca25 human 4af7513b61bc

Comprimir PDF

Reduce el tamaño de un archivo PDF submuestreando las imágenes incrustadas. Elige entre un control deslizante de calidad o un tamaño de archivo objetivo.

API Endpoint

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

Acepta datos de formulario multipart con un archivo PDF y un campo JSON settings.

Parameters

Parámetro Tipo Obligatorio Predeterminado Descripción
mode string No "quality" Modo de compresión: quality o targetSize
quality integer No 75 Calidad de compresión, 1-100 (mayor = menos compresión). Se usa en el modo quality
targetSizeKb number No - Tamaño de archivo objetivo en kilobytes. Se usa en el modo targetSize

Example Request

Comprimir por calidad:

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}'

Comprimir a un tamaño objetivo:

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

  • En el modo quality, los valores más bajos producen archivos más pequeños con mayor degradación de la imagen.
  • En el modo targetSize, una búsqueda binaria encuentra el DPI más alto que se ajusta al tamaño solicitado.
  • Si la compresión aumentara el tamaño del archivo, se devuelven los bytes originales sin cambios.
  • El contenido de texto y vectorial no se ve afectado; solo se submuestrean las imágenes rasterizadas incrustadas.