Files
SnapOtter/apps/docs/pl/tools/image/pixelate.md
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

2.4 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Zastosuj efekt pikselizacji do całego obrazu lub wybranego obszaru. a3ad29841f7b human f098fbbfdcab

Pikselizacja

Zastosuj efekt pikselizacji do całego obrazu lub wybranego prostokątnego obszaru. Przydatne do zasłaniania wrażliwej treści, takiej jak twarze, tablice rejestracyjne czy dane osobowe.

Punkt końcowy API

POST /api/v1/tools/image/pixelate

Przyjmuje dane formularza multipart z plikiem obrazu i polem JSON settings.

Parametry

Parametr Typ Wymagany Domyślnie Opis
blockSize integer Nie 12 Rozmiar bloku pikseli (2-128); większe wartości dają grubszą pikselizację
region object Nie - Ogranicz pikselizację do prostokąta (patrz poniżej)

Obiekt region

Pole Typ Wymagane Opis
left integer Tak Przesunięcie od lewej w pikselach (>= 0)
top integer Tak Przesunięcie od góry w pikselach (>= 0)
width integer Tak Szerokość obszaru w pikselach (>= 1)
height integer Tak Wysokość obszaru w pikselach (>= 1)

Przykładowe żądanie

Pikselizacja całego obrazu:

curl -X POST http://localhost:1349/api/v1/tools/image/pixelate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"blockSize": 20}'

Pikselizacja wybranego obszaru:

curl -X POST http://localhost:1349/api/v1/tools/image/pixelate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"blockSize": 16, "region": {"left": 100, "top": 50, "width": 200, "height": 150}}'

Przykładowa odpowiedź

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

Uwagi

  • Gdy region jest pominięty, pikselizowany jest cały obraz.
  • Współrzędne obszaru są podawane w pikselach względem lewego górnego rogu obrazu. Obszar musi mieścić się w granicach obrazu.
  • Format wyjściowy odpowiada formatowi wejściowemu. Pliki wejściowe HEIC, RAW, PSD i SVG są automatycznie dekodowane przed przetwarzaniem.