mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Réduisez la taille du fichier image par niveau de qualité ou vers une taille de fichier cible.	af4685da7e64	human	2b5f8ab95198

Compresser

Réduisez la taille du fichier image en spécifiant un niveau de qualité ou une taille de fichier cible en kilo-octets. L'outil utilise une recherche binaire itérative pour atteindre précisément les cibles de taille.

API Endpoint

POST /api/v1/tools/image/compress

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

Parameters

Paramètre	Type	Requis	Défaut	Description
mode	string	Non	`"quality"`	Mode de compression : `quality` ou `targetSize`
quality	number	Non	`80`	Niveau de qualité (1-100). Utilisé lorsque mode vaut `quality`.
targetSizeKb	number	Non	-	Taille de fichier cible en kilo-octets. Utilisée lorsque mode vaut `targetSize`.

Example Request

Compresser à la qualité 60 :

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

Compresser vers une taille cible de 200 Ko :

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

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 204800
}

Notes

En mode quality, les valeurs plus basses produisent des fichiers plus petits avec davantage d'artefacts de compression. Une valeur de 80 est une bonne valeur par défaut pour le web.
En mode targetSize, le moteur effectue une compression itérative pour se rapprocher le plus possible de la cible sans la dépasser.
Le format de sortie correspond au format d'entrée. La compression s'applique à l'encodage natif du format (par ex. qualité JPEG pour les fichiers JPEG, qualité WebP pour les fichiers WebP).
Si la qualité par défaut (80) convient, vous pouvez omettre entièrement le paramètre quality.

2.4 KiB Raw Blame History