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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Конвертуйте зображення між форматами, включно із сучасними форматами, як-от AVIF, JXL та HEIC.	2639f333073f	human	cc673ec4e84d

Конвертація зображення

Конвертуйте зображення між форматами. Підтримує поширені веб-формати, а також спеціалізовані формати, як-от HEIC, JXL, BMP, ICO, JP2, QOI та PSD.

API Endpoint

POST /api/v1/tools/image/convert

Приймає дані форми multipart із файлом зображення та полем JSON settings.

Parameters

Parameter	Type	Required	Default	Description
format	string	Yes	-	Цільовий формат: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	No	-	Якість вихідного файлу (1-100). Застосовується до форматів зі втратами, як-от jpg, webp, avif, heic.

Supported Output Formats

Format	Type	Notes
jpg	Lossy	JPEG, найкраща сумісність
png	Lossless	Підтримує прозорість
webp	Both	Сучасний веб-формат, хороше стиснення
avif	Lossy	Формат нового покоління, чудове стиснення
tiff	Both	Робочі процеси друку/видавництва
gif	Lossless	Обмежено 256 кольорами
heic / heif	Lossy	Формат екосистеми Apple
jxl	Both	JPEG XL, формат нового покоління
bmp	Lossless	Нестиснена растрова карта
ico	Lossless	Формат значків Windows
jp2	Lossy	JPEG 2000
qoi	Lossless	Формат Quite OK Image
psd	Layered	Adobe Photoshop (потребує ImageMagick)
ppm	Lossless	Portable Pixmap (PPM/PGM/PBM)
eps	Vector	Encapsulated PostScript
tga	Lossless	Формат зображень Targa

Example Request

Конвертувати у 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}'

Конвертувати у PNG (без втрат):

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

Example Response

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

Notes

Розширення вихідного файлу автоматично оновлюється відповідно до цільового формату.
Вхідні дані SVG растеризуються з роздільною здатністю 300 DPI перед конвертацією.
Конвертація PSD потребує встановлення ImageMagick на сервері.
BMP, EPS, ICO, JP2, JXL, PPM, QOI та TGA використовують спеціалізовані CLI-кодувальники та обходять обробку Sharp.
Кодування HEIC/HEIF використовує системну бібліотеку кодувальника HEIC.
Вхідні формати широкі: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW тощо), PSD, SVG, BMP та інші.

3.9 KiB Raw Blame History