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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Konvertiert Bilder zwischen Formaten, einschließlich moderner Formate wie AVIF, JXL und HEIC.	2639f333073f	human	1a9d52e38c55

Bild konvertieren

Konvertiert Bilder zwischen Formaten. Unterstützt gängige Webformate sowie spezialisierte Formate wie HEIC, JXL, BMP, ICO, JP2, QOI und PSD.

API-Endpunkt

POST /api/v1/tools/image/convert

Akzeptiert Multipart-Formulardaten mit einer Bilddatei und einem JSON-Feld settings.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
format	string	Ja	-	Zielformat: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	Nein	-	Ausgabequalität (1-100). Gilt für verlustbehaftete Formate wie jpg, webp, avif, heic.

Unterstützte Ausgabeformate

Format	Typ	Hinweise
jpg	Verlustbehaftet	JPEG, beste Kompatibilität
png	Verlustfrei	Unterstützt Transparenz
webp	Beides	Modernes Webformat, gute Komprimierung
avif	Verlustbehaftet	Format der nächsten Generation, ausgezeichnete Komprimierung
tiff	Beides	Druck-/Publishing-Workflows
gif	Verlustfrei	Auf 256 Farben beschränkt
heic / heif	Verlustbehaftet	Format des Apple-Ökosystems
jxl	Beides	JPEG XL, Format der nächsten Generation
bmp	Verlustfrei	Unkomprimierte Bitmap
ico	Verlustfrei	Windows-Symbolformat
jp2	Verlustbehaftet	JPEG 2000
qoi	Verlustfrei	Quite OK Image-Format
psd	Ebenen	Adobe Photoshop (erfordert ImageMagick)
ppm	Verlustfrei	Portable Pixmap (PPM/PGM/PBM)
eps	Vektor	Encapsulated PostScript
tga	Verlustfrei	Targa-Bildformat

Beispielanfrage

In WebP konvertieren:

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

In PNG konvertieren (verlustfrei):

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

Beispielantwort

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

Hinweise

Die Erweiterung des Ausgabedateinamens wird automatisch an das Zielformat angepasst.
SVG-Eingaben werden vor der Konvertierung mit 300 DPI gerastert.
Die PSD-Konvertierung erfordert, dass ImageMagick auf dem Server installiert ist.
BMP, EPS, ICO, JP2, JXL, PPM, QOI und TGA verwenden spezialisierte CLI-Encoder und umgehen die Sharp-Verarbeitung.
Die HEIC/HEIF-Kodierung verwendet die HEIC-Encoder-Bibliothek des Systems.
Die Eingabeformate sind vielfältig: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW usw.), PSD, SVG, BMP und mehr.

3.2 KiB Raw Blame History