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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Ändra storlek på bilder efter pixlar, procent eller med anpassningslägen.	53866e8266b8	human	1e73827cf480

Ändra bildstorlek

Ändra storlek på bilder genom att ange exakta pixeldimensioner, en procentuell skalfaktor eller ett anpassningsläge som styr hur bilden anpassas till måldimensionerna.

API-slutpunkt

POST /api/v1/tools/image/resize

Tar emot multipart-formulärdata med en bildfil och ett JSON-fält settings.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
width	integer	Nej	-	Målbredd i pixlar (max 16383)
height	integer	Nej	-	Målhöjd i pixlar (max 16383)
fit	string	Nej	`"contain"`	Hur bilden anpassas till dimensionerna: `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Nej	`false`	Förhindra uppskalning om bilden är mindre än målet
percentage	number	Nej	-	Skala med procent (t.ex. 50 för halv storlek)

Minst en av width, height eller percentage måste anges.

Anpassningslägen

contain - Ändra storlek för att rymmas inom dimensionerna, med bevarat bildförhållande (kan lämna tomt utrymme)
cover - Ändra storlek för att täcka dimensionerna, med bevarat bildförhållande (kan beskära)
fill - Sträck ut för att exakt matcha dimensionerna (ignorerar bildförhållande)
inside - Som contain, men skalar bara ned, aldrig upp
outside - Som cover, men skalar bara ned, aldrig upp

Exempelförfrågan

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

Ändra storlek med procent:

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

Exempelsvar

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

Anteckningar

Maximal dimension är 16383 pixlar på vardera axeln (Sharp/libvips-gräns).
Utdataformatet matchar indataformatet. HEIC-, RAW-, PSD- och SVG-indata avkodas automatiskt före bearbetning.
EXIF-orientering appliceras automatiskt före storleksändring.
Flaggan withoutEnlargement är användbar för batchbearbetning där vissa bilder redan kan vara mindre än målet.

2.7 KiB Raw Blame History