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
Thay đổi kích thước bằng khắc đường nối, thêm hoặc bớt pixel dọc theo các đường ít quan trọng để giữ nội dung chính và khuôn mặt.	f383b28ab62a	human	309a642544f6

Thay đổi kích thước theo nội dung

Thay đổi kích thước bằng khắc đường nối, loại bỏ hoặc thêm pixel một cách thông minh dọc theo các đường ít quan trọng nhất về mặt thị giác, giữ lại nội dung quan trọng và tùy chọn bảo vệ khuôn mặt.

API Endpoint

POST /api/v1/tools/image/content-aware-resize

Xử lý: Đồng bộ (trả về kết quả trực tiếp)

Bộ mô hình: Không cần cho thao tác cơ bản. Bảo vệ khuôn mặt sử dụng bộ face-detection (200-300 MB) nếu bật.

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
file	file	Có	-	Tệp ảnh (multipart)
width	number	Không	-	Chiều rộng mục tiêu tính bằng pixel
height	number	Không	-	Chiều cao mục tiêu tính bằng pixel
protectFaces	boolean	Không	`false`	Phát hiện và bảo vệ khuôn mặt khỏi bị khắc bỏ đường nối
blurRadius	number	Không	`4`	Bán kính làm mờ tiền xử lý để tính năng lượng (0-20)
sobelThreshold	number	Không	`2`	Ngưỡng phát hiện cạnh Sobel (1-20). Giá trị cao hơn khiến thuật toán quyết liệt hơn
square	boolean	Không	`false`	Thay đổi kích thước thành hình vuông (dùng chiều nhỏ hơn)

Phải chỉ định ít nhất một trong width, height hoặc square.

Ví dụ yêu cầu

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "file=@landscape.jpg" \
  -F 'settings={"width":800,"protectFaces":true}'

Phản hồi (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Ghi chú

Tuyến tùy chỉnh này hiện trả về phản hồi 200 đồng bộ.
Sử dụng thư viện khắc đường nối caire để thay đổi kích thước theo nội dung.
Chỉ giảm kích thước (loại bỏ đường nối). Không thể mở rộng ảnh vượt quá kích thước ban đầu.
Tùy chọn protectFaces dùng AI phát hiện khuôn mặt để đánh dấu vùng mặt là năng lượng cao, ngăn đường nối đi qua khuôn mặt.
blurRadius kiểm soát mức làm mượt trước khi tính bản đồ năng lượng. Giá trị cao hơn làm bản đồ năng lượng đồng đều hơn, có thể giú ích với ảnh nhiều nhiễu.
sobelThreshold ảnh hưởng đến mức độ quyết liệt khi phát hiện cạnh. Giá trị thấp hơn giữ lại nhiều cạnh tinh tế hơn.
Đầu ra luôn ở định dạng PNG.
Hỗ trợ định dạng đầu vào HEIC/HEIF, RAW, TGA, PSD, EXR và HDR thông qua giải mã tự động.

3.3 KiB Raw Blame History