mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
1.7 KiB
1.7 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Thêm các thanh màu đơn sắc để vừa với một tỷ lệ khung hình mục tiêu. | b8e17dffc341 | human | 9fc281d6e853 |
Aspect Pad
Thêm các thanh letterbox hoặc pillarbox màu đơn sắc để đưa một video vừa vào một tỷ lệ khung hình mục tiêu mà không cắt xén.
API Endpoint
POST /api/v1/tools/video/aspect-pad
Chấp nhận dữ liệu biểu mẫu multipart với một tệp video và một trường JSON settings.
Parameters
| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| target | string | Không | "9:16" |
Tỷ lệ khung hình mục tiêu: 16:9, 9:16, 1:1, 4:3, 3:4 |
| color | string | Không | "#000000" |
Màu hex cho các thanh đệm (ví dụ "#000000" cho màu đen) |
Example Request
curl -X POST http://localhost:1349/api/v1/tools/video/aspect-pad \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@clip.mp4" \
-F 'settings={"target": "1:1", "color": "#ffffff"}'
Example Response
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
"originalSize": 12500000,
"processedSize": 13200000
}
Notes
- Nếu video đã khớp với tỷ lệ khung hình mục tiêu, tệp được trả về không thay đổi.
- Dùng
9:16cho các định dạng mạng xã hội dọc/khổ đứng (TikTok, Reels, Shorts). - Để có đệm làm mờ thay vì màu đơn sắc, hãy dùng công cụ Blur Pad.