mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
---
|
|
description: "Áp dụng hiệu ứng pixel hóa cho toàn bộ ảnh hoặc một vùng cụ thể."
|
|
i18n_source_hash: a3ad29841f7b
|
|
i18n_provenance: human
|
|
i18n_output_hash: bafa897197cd
|
|
---
|
|
|
|
# Pixelate {#pixelate}
|
|
|
|
Áp dụng hiệu ứng pixel hóa cho toàn bộ ảnh hoặc một vùng hình chữ nhật cụ thể. Hữu ích để che nội dung nhạy cảm như khuôn mặt, biển số xe hoặc thông tin cá nhân.
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/pixelate`
|
|
|
|
Chấp nhận multipart form data với một tệp ảnh và một trường JSON `settings`.
|
|
|
|
## Parameters {#parameters}
|
|
|
|
| Parameter | Type | Required | Default | Description |
|
|
|-----------|------|----------|---------|-------------|
|
|
| blockSize | integer | No | `12` | Kích thước khối pixel (2-128); giá trị càng lớn tạo pixel hóa càng thô |
|
|
| region | object | No | - | Giới hạn pixel hóa trong một hình chữ nhật (xem bên dưới) |
|
|
|
|
### Region Object {#region-object}
|
|
|
|
| Field | Type | Required | Description |
|
|
|-------|------|----------|-------------|
|
|
| left | integer | Yes | Độ lệch trái tính bằng pixel (>= 0) |
|
|
| top | integer | Yes | Độ lệch trên tính bằng pixel (>= 0) |
|
|
| width | integer | Yes | Chiều rộng vùng tính bằng pixel (>= 1) |
|
|
| height | integer | Yes | Chiều cao vùng tính bằng pixel (>= 1) |
|
|
|
|
## Example Request {#example-request}
|
|
|
|
Pixel hóa toàn bộ ảnh:
|
|
|
|
```bash
|
|
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}'
|
|
```
|
|
|
|
Pixel hóa một vùng cụ thể:
|
|
|
|
```bash
|
|
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}}'
|
|
```
|
|
|
|
## Example Response {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
|
"originalSize": 2450000,
|
|
"processedSize": 2380000
|
|
}
|
|
```
|
|
|
|
## Notes {#notes}
|
|
|
|
- Khi bỏ qua `region`, toàn bộ ảnh sẽ được pixel hóa.
|
|
- Tọa độ vùng tính bằng pixel tương đối với góc trên bên trái của ảnh. Vùng phải nằm trong ranh giới ảnh.
|
|
- Định dạng đầu ra khớp với định dạng đầu vào. Các đầu vào HEIC, RAW, PSD và SVG được tự động giải mã trước khi xử lý.
|