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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Faites pivoter les images de n'importe quel angle et retournez-les horizontalement ou verticalement.	c4ed5f7e270b	human	05069a24e70c

Rotation et miroir d'image

Faites pivoter les images d'un angle arbitraire et/ou retournez-les horizontalement ou verticalement. Les opérations de rotation et de retournement peuvent être combinées dans une seule requête.

Point de terminaison API

POST /api/v1/tools/image/rotate

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
angle	number	Non	`0`	Angle de rotation en degrés (sens horaire). Accepte toute valeur numérique.
horizontal	boolean	Non	`false`	Retourner l'image horizontalement (miroir)
vertical	boolean	Non	`false`	Retourner l'image verticalement

Exemple de requête

Pivoter de 90 degrés dans le sens horaire :

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

Retourner horizontalement :

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

Pivoter et retourner en même temps :

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"angle": 45, "vertical": true}'

Exemple de réponse

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

Remarques

La rotation est appliquée en premier, puis les opérations de retournement.
Les rotations non multiples de 90 degrés (par exemple 45 degrés) agrandissent le canevas pour contenir l'image pivotée, avec un remplissage transparent ou noir selon le format de sortie.
Valeurs courantes : 90, 180, 270 pour les rotations d'un quart de tour.
L'orientation EXIF est appliquée automatiquement avant le traitement, de sorte que la rotation est relative à l'orientation visuelle.

2.5 KiB Raw Blame History