mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

2.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Chia một ảnh thành các ô lưới theo hàng và cột hoặc theo kích thước pixel, trả về dưới dạng kho lưu trữ ZIP.	838f5fa791b0	human	b767a4ac891e

Tách ảnh

Chia một ảnh đơn thành các ô lưới theo số cột/hàng hoặc theo kích thước pixel cụ thể. Trả về một kho lưu trữ ZIP chứa tất cả các ô.

API Endpoint

POST /api/v1/tools/image/split

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
columns	integer	Không	3	Số cột để chia (1 đến 100)
rows	integer	Không	3	Số hàng để chia (1 đến 100)
tileWidth	integer	Không	-	Chiều rộng ô tính bằng pixel (tối thiểu 10). Ghi đè `columns` khi cả `tileWidth` và `tileHeight` đều được đặt.
tileHeight	integer	Không	-	Chiều cao ô tính bằng pixel (tối thiểu 10). Ghi đè `rows` khi cả `tileWidth` và `tileHeight` đều được đặt.
outputFormat	string	Không	`"original"`	Định dạng đầu ra cho các ô: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Không	90	Chất lượng đầu ra cho các định dạng có mất dữ liệu (1 đến 100)

Ví dụ Request

curl -X POST http://localhost:1349/api/v1/tools/image/split \
  -F "file=@large-image.png" \
  -F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
  --output split-tiles.zip

Ví dụ Response

Response được truyền trực tiếp dưới dạng tệp ZIP với Content-Type: application/zip. Tên tệp theo mẫu split-<jobId>.zip.

Mỗi ô bên trong ZIP được đặt tên <originalBaseName>_r<row>_c<col>.<ext> (ví dụ photo_r1_c1.png, photo_r2_c3.webp).

Ghi chú

Chấp nhận một tệp ảnh đơn.
Hỗ trợ các định dạng đầu vào HEIC, RAW, PSD, và SVG (tự động giải mã).
Khi cả tileWidth và tileHeight đều được cung cấp, chúng được ưu tiên hơn columns/rows. Kích thước lưới được tính là ceil(imageWidth / tileWidth) và ceil(imageHeight / tileHeight).
Các ô ở cạnh (cột ngoài cùng bên phải, hàng dưới cùng) có thể nhỏ hơn kích thước ô được chỉ định nếu kích thước ảnh không chia hết.
Kích thước lưới tối đa được giới hạn ở 100x100 (10.000 ô).
Response truyền trực tiếp tệp ZIP nên không có thân JSON. Dùng --output với curl để lưu tệp.

2.7 KiB Raw Blame History