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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Уменьшение размера файла изображения по уровню качества или до целевого размера файла.	af4685da7e64	human	6f0e13bce232

Сжатие

Уменьшайте размер файла изображения, задавая уровень качества или целевой размер файла в килобайтах. Инструмент использует итеративный двоичный поиск для точного достижения целевого размера.

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

POST /api/v1/tools/image/compress

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

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
mode	string	Нет	`"quality"`	Режим сжатия: `quality` или `targetSize`
quality	number	Нет	`80`	Уровень качества (1-100). Используется, когда режим равен `quality`.
targetSizeKb	number	Нет	-	Целевой размер файла в килобайтах. Используется, когда режим равен `targetSize`.

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

Сжатие до качества 60:

curl -X POST http://localhost:1349/api/v1/tools/image/compress \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"mode": "quality", "quality": 60}'

Сжатие до целевого размера 200 КБ:

curl -X POST http://localhost:1349/api/v1/tools/image/compress \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"mode": "targetSize", "targetSizeKb": 200}'

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

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

Примечания

В режиме quality меньшие значения дают файлы меньшего размера с бóльшим количеством артефактов сжатия. Значение 80 является хорошим значением по умолчанию для веб-использования.
В режиме targetSize движок выполняет итеративное сжатие, чтобы максимально приблизиться к целевому размеру, не превышая его.
Формат вывода соответствует формату ввода. Сжатие применяется к нативному кодированию формата (например, качество JPEG для файлов JPEG, качество WebP для файлов WebP).
Если качество по умолчанию (80) приемлемо, вы можете полностью опустить параметр quality.

3.3 KiB Raw Blame History Unescape Escape