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.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.	562f8270e8c3	human	7d07d56af008

Konwersja

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