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

2.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Cắt ảnh bằng cách chỉ định một vùng với vị trí và kích thước.	aab38ccd7c53	human	da847123a2f2

Cắt ảnh

Cắt ảnh bằng cách xác định một vùng hình chữ nhật dựa trên vị trí và kích thước. Hỗ trợ cả đơn vị pixel và phần trăm.

API Endpoint

POST /api/v1/tools/image/crop

Chấp nhận dữ liệu form multipart với một tệp ảnh và một trường JSON settings.

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
left	number	Có	-	Độ lệch X của vùng cắt (tính từ cạnh trái)
top	number	Có	-	Độ lệch Y của vùng cắt (tính từ cạnh trên)
width	number	Có	-	Chiều rộng của vùng cắt
height	number	Có	-	Chiều cao của vùng cắt
unit	string	Không	`"px"`	Đơn vị cho các giá trị: `px` hoặc `percent`

Ví dụ yêu cầu

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

Cắt bằng giá trị phần trăm:

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 10, "top": 10, "width": 80, "height": 80, "unit": "percent"}'

Ví dụ phản hồi

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

Ghi chú

Vùng cắt phải nằm trong ranh giới ảnh. Nếu vùng vượt ra ngoài ảnh, yêu cầu sẽ thất bại.
Khi dùng đơn vị percent, các giá trị biểu thị phần trăm của kích thước ảnh (ví dụ left: 10 nghĩa là 10% tính từ cạnh trái).
Định dạng đầu ra khớp với định dạng đầu vào.
Định hướng EXIF được áp dụng tự động trước khi cắt, nên tọa độ tương ứng với định hướng đúng về mặt thị giác.

2.4 KiB Raw Blame History