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

3.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Redimensionnez les images en pixels, en pourcentage ou avec des modes d'ajustement.	53866e8266b8	human	8e0697d78a16

Redimensionner une image

Redimensionnez les images en spécifiant des dimensions exactes en pixels, un facteur d'échelle en pourcentage ou un mode d'ajustement qui contrôle la façon dont l'image s'adapte aux dimensions cibles.

Point de terminaison API

POST /api/v1/tools/image/resize

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

Paramètres

Paramètre	Type	Requis	Défaut	Description
width	integer	Non	-	Largeur cible en pixels (max 16383)
height	integer	Non	-	Hauteur cible en pixels (max 16383)
fit	string	Non	`"contain"`	Comment l'image s'ajuste aux dimensions : `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Non	`false`	Empêcher l'agrandissement si l'image est plus petite que la cible
percentage	number	Non	-	Mettre à l'échelle par pourcentage (par exemple 50 pour la moitié de la taille)

Au moins l'un de width, height ou percentage doit être fourni.

Modes d'ajustement

contain - Redimensionner pour tenir dans les dimensions, en préservant le rapport d'aspect (peut laisser de l'espace vide)
cover - Redimensionner pour couvrir les dimensions, en préservant le rapport d'aspect (peut recadrer)
fill - Étirer pour correspondre exactement aux dimensions (ignore le rapport d'aspect)
inside - Comme contain, mais réduit uniquement, n'agrandit jamais
outside - Comme cover, mais réduit uniquement, n'agrandit jamais

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"width": 800, "height": 600, "fit": "contain"}'

Redimensionner par pourcentage :

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"percentage": 50}'

Exemple de réponse

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

Remarques

La dimension maximale est de 16383 pixels sur chaque axe (limite de Sharp/libvips).
Le format de sortie correspond au format d'entrée. Les entrées HEIC, RAW, PSD et SVG sont automatiquement décodées avant le traitement.
L'orientation EXIF est appliquée automatiquement avant le redimensionnement.
L'indicateur withoutEnlargement est utile pour le traitement par lots où certaines images peuvent déjà être plus petites que la cible.

3.0 KiB Raw Blame History