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

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +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.	342c5cf1f864	human	2b5f8ab95198

Compresser une image

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