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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Konvertera bilder mellan format, inklusive moderna format som AVIF, JXL och HEIC.	2639f333073f	human	84c5f269c843

Konvertera bild

Konvertera bilder mellan format. Stöder vanliga webbformat samt specialiserade format som HEIC, JXL, BMP, ICO, JP2, QOI och PSD.

API-slutpunkt

POST /api/v1/tools/image/convert

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

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
format	string	Ja	-	Målformat: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	Nej	-	Utdatakvalitet (1-100). Gäller förlustbehäftade format som jpg, webp, avif, heic.

Utdataformat som stöds

Format	Typ	Anteckningar
jpg	Förlustbehäftat	JPEG, bäst kompatibilitet
png	Förlustfritt	Stöder transparens
webp	Båda	Modernt webbformat, bra komprimering
avif	Förlustbehäftat	Nästa generations format, utmärkt komprimering
tiff	Båda	Tryck-/publiceringsarbetsflöden
gif	Förlustfritt	Begränsat till 256 färger
heic / heif	Förlustbehäftat	Apples ekosystemformat
jxl	Båda	JPEG XL, nästa generations format
bmp	Förlustfritt	Okomprimerad bitmapp
ico	Förlustfritt	Windows-ikonformat
jp2	Förlustbehäftat	JPEG 2000
qoi	Förlustfritt	Quite OK Image-format
psd	Skiktat	Adobe Photoshop (kräver ImageMagick)
ppm	Förlustfritt	Portable Pixmap (PPM/PGM/PBM)
eps	Vektor	Encapsulated PostScript
tga	Förlustfritt	Targa-bildformat

Exempelbegäran

Konvertera till WebP:

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

Konvertera till PNG (förlustfritt):

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

Exempelsvar

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

Anteckningar

Utdatafilens filtillägg uppdateras automatiskt för att matcha målformatet.
SVG-indata rastreras vid 300 DPI före konvertering.
PSD-konvertering kräver att ImageMagick är installerat på servern.
BMP, EPS, ICO, JP2, JXL, PPM, QOI och TGA använder specialiserade CLI-kodare och kringgår Sharp-bearbetning.
HEIC/HEIF-kodning använder systemets HEIC-kodarbibliotek.
Indataformaten är breda: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW osv.), PSD, SVG, BMP med flera.

3.1 KiB Raw Blame History