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
Konwertuj obrazy między formatami, w tym nowoczesnymi jak AVIF, JXL i HEIC.	2639f333073f	human	7d07d56af008

Konwertuj obraz

Konwertuj obrazy między formatami. Obsługuje popularne formaty webowe oraz specjalistyczne, takie jak HEIC, JXL, BMP, ICO, JP2, QOI i PSD.

Punkt końcowy API

POST /api/v1/tools/image/convert

Przyjmuje dane formularza multipart z plikiem obrazu oraz polem JSON settings.

Parametry

Parametr	Typ	Wymagany	Domyślnie	Opis
format	string	Tak	-	Format docelowy: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	Nie	-	Jakość wyjściowa (1-100). Dotyczy formatów stratnych, takich jak jpg, webp, avif, heic.

Obsługiwane formaty wyjściowe

Format	Typ	Uwagi
jpg	Stratny	JPEG, najlepsza kompatybilność
png	Bezstratny	Obsługuje przezroczystość
webp	Oba	Nowoczesny format webowy, dobra kompresja
avif	Stratny	Format nowej generacji, doskonała kompresja
tiff	Oba	Procesy druku/publikacji
gif	Bezstratny	Ograniczony do 256 kolorów
heic / heif	Stratny	Format ekosystemu Apple
jxl	Oba	JPEG XL, format nowej generacji
bmp	Bezstratny	Nieskompresowana mapa bitowa
ico	Bezstratny	Format ikon Windows
jp2	Stratny	JPEG 2000
qoi	Bezstratny	Format Quite OK Image
psd	Warstwowy	Adobe Photoshop (wymaga ImageMagick)
ppm	Bezstratny	Portable Pixmap (PPM/PGM/PBM)
eps	Wektorowy	Encapsulated PostScript
tga	Bezstratny	Format obrazu Targa

Przykładowe żądanie

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

Konwersja do PNG (bezstratna):

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

Przykładowa odpowiedź

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

Uwagi

Rozszerzenie nazwy pliku wyjściowego jest automatycznie aktualizowane, aby pasowało do formatu docelowego.
Pliki wejściowe SVG są rasteryzowane w 300 DPI przed konwersją.
Konwersja PSD wymaga zainstalowanego na serwerze ImageMagick.
Formaty BMP, EPS, ICO, JP2, JXL, PPM, QOI i TGA używają specjalistycznych koderów CLI i pomijają przetwarzanie przez Sharp.
Kodowanie HEIC/HEIF używa systemowej biblioteki kodera HEIC.
Formaty wejściowe są szerokie: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW itd.), PSD, SVG, BMP i inne.

3.1 KiB Raw Blame History