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.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Tạo một ảnh giữ chỗ chất lượng thấp cực nhỏ với data URI base64.	f8a27c8021f5	human	d4af6608825f

Ảnh giữ chỗ LQIP

Tạo một ảnh giữ chỗ chất lượng thấp cực nhỏ (LQIP) từ một ảnh nguồn. Trả về một tệp giữ chỗ nhỏ cùng với một data URI base64, thẻ HTML <img> sẵn sàng dùng, và đoạn CSS background-image để nhúng ngay lập tức.

Điểm cuối API

POST /api/v1/tools/image/lqip-placeholder

Chấp nhận dữ liệu biểu mẫu 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ả
width	integer	Không	`16`	Chiều rộng đích tính bằng pixel (4-64)
blur	number	Không	`2`	Bán kính làm mờ cho chiến lược blur (0-20)
strategy	string	Không	`"blur"`	Chiến lược giữ chỗ: `blur`, `pixelate`, hoặc `solid`
format	string	Không	`"webp"`	Định dạng đầu ra: `webp`, `png`, hoặc `jpeg`
quality	integer	Không	`50`	Chất lượng đầu ra (1-100)

Ví dụ yêu cầu

curl -X POST http://localhost:1349/api/v1/tools/image/lqip-placeholder \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"width": 20, "strategy": "blur", "format": "webp"}'

Ví dụ phản hồi

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 2450000,
  "processedSize": 280,
  "dataUri": "data:image/webp;base64,UklGR...",
  "width": 20,
  "height": 13,
  "bytes": 280,
  "strategy": "blur",
  "html": "<img src=\"data:image/webp;base64,UklGR...\" />",
  "css": "background-image:url('data:image/webp;base64,UklGR...');background-size:cover;background-position:center;"
}

Ghi chú

Trường dataUri chứa data URI hoàn chỉnh, sẵn sàng dùng trong các thuộc tính src hoặc CSS mà không cần yêu cầu bổ sung nào.
Các trường html và css cung cấp các đoạn sao-chép-dán cho các trường hợp dùng phổ biến.
Chiến lược blur tạo ra một thumbnail mềm, mờ. Chiến lược pixelate tạo ra một khảm ô vuông. Chiến lược solid trả về một màu trung bình duy nhất.
Kích thước giữ chỗ điển hình là 200-500 byte, khiến chúng phù hợp để nhúng trực tiếp trong HTML.
Chiều cao được tính tự động để giữ tỷ lệ khung hình của ảnh nguồn.
Đầu vào HEIC, RAW, PSD và SVG được giải mã tự động trước khi xử lý.

2.9 KiB Raw Blame History