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

4.3 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	43553b7ef94f

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

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

Конечная точка API

POST /api/v1/tools/image/convert

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

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
format	string	Да	-	Целевой формат: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	Нет	-	Качество вывода (1-100). Применяется к форматам с потерями, таким как jpg, webp, avif, heic.

Поддерживаемые выходные форматы

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

Пример запроса

Преобразование в 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"}'

Пример ответа

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

Примечания

Расширение имени выходного файла автоматически обновляется в соответствии с целевым форматом.
Входные данные 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 и другие.

4.3 KiB Raw Blame History Unescape Escape