Files
SnapOtter/apps/docs/fr/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.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Réduire la taille d'un fichier PDF en compressant les images intégrées. a8bb0baaca25 human dad97321f449

Compresser un PDF

Réduisez la taille d'un fichier PDF en sous-échantillonnant les images intégrées. Choisissez entre un curseur de qualité ou une taille de fichier cible.

Point de terminaison de l'API

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

Accepte des données de formulaire multipart avec un fichier PDF et un champ settings au format JSON.

Paramètres

Paramètre Type Requis Par défaut Description
mode string Non "quality" Mode de compression : quality ou targetSize
quality integer Non 75 Qualité de compression, 1-100 (plus élevé = moins de compression). Utilisé en mode quality
targetSizeKb number Non - Taille de fichier cible en kilo-octets. Utilisé en mode targetSize

Exemple de requête

Compresser par qualité :

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

Compresser jusqu'à une taille cible :

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

Exemple de réponse

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

Remarques

  • En mode quality, des valeurs plus basses produisent des fichiers plus petits avec une plus forte dégradation des images.
  • En mode targetSize, une recherche binaire trouve le DPI le plus élevé qui respecte la taille demandée.
  • Si la compression devait agrandir le fichier, les octets d'origine sont renvoyés inchangés.
  • Le texte et le contenu vectoriel ne sont pas affectés ; seules les images matricielles intégrées sont sous-échantillonnées.