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

3.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Optimera bilder för webbleverans med formatkonvertering, kvalitetskontroll, storleksändring och borttagning av metadata.	c327bbbce768	human	797dfa090fa6

Optimera för webb

Optimera bilder för webbleverans i ett enda steg. Kombinerar formatkonvertering, kvalitetsjustering, valfri storleksändring, progressiv kodning och borttagning av metadata.

API-slutpunkt

POST /api/v1/tools/image/optimize-for-web

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

En slutpunkt för direktförhandsvisning finns också på POST /api/v1/tools/image/optimize-for-web/preview, som returnerar den bearbetade bilden direkt som binärdata (ingen arbetsyta skapas) för justering av parametrar i realtid.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
format	string	Nej	`"webp"`	Utdataformat: `webp`, `jpeg`, `avif`, `png`, `jxl`
quality	number	Nej	`80`	Utdatakvalitet (1-100)
maxWidth	number	Nej	-	Maximal bredd i pixlar. Bilden skalas ned om den är bredare.
maxHeight	number	Nej	-	Maximal höjd i pixlar. Bilden skalas ned om den är högre.
progressive	boolean	Nej	`true`	Aktivera progressiv/sammanflätad kodning
stripMetadata	boolean	Nej	`true`	Ta bort EXIF-, GPS-, ICC- och XMP-metadata

Exempelförfrågan

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "webp", "quality": 75, "maxWidth": 1920}'

Optimera för AVIF med aggressiv komprimering:

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "avif", "quality": 50, "maxWidth": 1200, "maxHeight": 800}'

Exempelsvar

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 4500000,
  "processedSize": 320000
}

Svar från förhandsvisningsslutpunkten

Förhandsvisningsslutpunkten (/api/v1/tools/image/optimize-for-web/preview) returnerar den binära bilden direkt med informationsrubriker:

X-Original-Size - Ursprunglig filstorlek i byte
X-Processed-Size - Bearbetad filstorlek i byte
X-Output-Filename - URL-kodat utdatafilnamn

Anteckningar

Detta verktyg är utformat som en komplett optimeringspipeline för webbtillgångar. Det hanterar formatkonvertering, kvalitetsjustering, maxdimensionsbegränsning och borttagning av metadata i ett enda pass.
Utdatafilnamnets filändelse uppdateras för att matcha det valda formatet.
JXL-kodning (JPEG XL) använder en specialiserad CLI-kodare. Bilden bearbetas först som PNG och kodas sedan till JXL.
Progressiv kodning förbättrar den upplevda inläsningstiden för JPEG och PNG genom att låta webbläsare rendera en förhandsvisning med låg kvalitet innan hela bilden läses in.
Förhandsvisningsslutpunkten är lättare (ingen arbetsyta/jobb skapas) och är avsedd för frontendens användargränssnitt för justering av parametrar i realtid.

3.4 KiB Raw Blame History