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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Optimalkan gambar untuk pengiriman web dengan konversi format, kontrol kualitas, pengubahan ukuran, dan penghapusan metadata.	c327bbbce768	human	a0eddef99d35

Optimize for Web

Optimalkan gambar untuk pengiriman web dalam satu langkah. Menggabungkan konversi format, penyesuaian kualitas, pengubahan ukuran opsional, enkode progresif, dan penghapusan metadata.

API Endpoint

POST /api/v1/tools/image/optimize-for-web

Menerima multipart form data dengan berkas gambar dan field JSON settings.

Endpoint live preview juga tersedia di POST /api/v1/tools/image/optimize-for-web/preview, yang mengembalikan gambar yang telah diproses secara langsung sebagai biner (tanpa membuat workspace) untuk penyetelan parameter secara real-time.

Parameters

Parameter	Type	Required	Default	Description
format	string	No	`"webp"`	Format output: `webp`, `jpeg`, `avif`, `png`, `jxl`
quality	number	No	`80`	Kualitas output (1-100)
maxWidth	number	No	-	Lebar maksimum dalam piksel. Gambar diperkecil jika lebih lebar.
maxHeight	number	No	-	Tinggi maksimum dalam piksel. Gambar diperkecil jika lebih tinggi.
progressive	boolean	No	`true`	Aktifkan enkode progresif/interlaced
stripMetadata	boolean	No	`true`	Hapus metadata EXIF, GPS, ICC, dan XMP

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "webp", "quality": 75, "maxWidth": 1920}'

Optimalkan untuk AVIF dengan kompresi agresif:

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "avif", "quality": 50, "maxWidth": 1200, "maxHeight": 800}'

Example Response

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

Preview Endpoint Response

Endpoint preview (/api/v1/tools/image/optimize-for-web/preview) mengembalikan gambar biner secara langsung dengan header informasional:

X-Original-Size - Ukuran berkas asli dalam byte
X-Processed-Size - Ukuran berkas yang telah diproses dalam byte
X-Output-Filename - Nama berkas output yang telah di-encode URL

Notes

Alat ini dirancang sebagai pipeline optimasi satu-atap untuk aset web. Alat ini menangani konversi format, penyetelan kualitas, pembatasan dimensi maksimum, dan penghapusan metadata dalam satu lintasan.
Ekstensi nama berkas output diperbarui agar sesuai dengan format yang dipilih.
Enkode JXL (JPEG XL) menggunakan enkoder CLI khusus. Gambar diproses terlebih dahulu sebagai PNG, lalu di-encode ke JXL.
Enkode progresif memperbaiki waktu muat yang dirasakan untuk JPEG dan PNG dengan memungkinkan peramban merender pratinjau kualitas rendah sebelum gambar penuh selesai dimuat.
Endpoint preview lebih ringan (tanpa pembuatan workspace/job) dan ditujukan untuk UI penyetelan parameter live di frontend.

3.4 KiB Raw Blame History