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.
2.2 KiB
2.2 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Đổi tỷ lệ video sang độ phân giải mới hoặc kích thước preset. | bb1f67871fea | human | d47762829e04 |
Resize Video
Đổi tỷ lệ video sang độ phân giải mới bằng cách dùng kích thước pixel tùy chỉnh hoặc một preset chuẩn.
API Endpoint
POST /api/v1/tools/video/resize-video
Nhận multipart form data gồm một file video và một trường JSON settings.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| width | integer | No | - | Chiều rộng mục tiêu tính bằng pixel (16-7680) |
| height | integer | No | - | Chiều cao mục tiêu tính bằng pixel (16-4320) |
| preset | string | No | "custom" |
Preset độ phân giải: custom, 2160p, 1440p, 1080p, 720p, 480p, 360p |
Khi preset là "custom", phải cung cấp ít nhất một trong width hoặc height. Kích thước còn lại đổi tỷ lệ theo tương ứng.
Example Request
curl -X POST http://localhost:1349/api/v1/tools/video/resize-video \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@clip.mp4" \
-F 'settings={"preset": "720p"}'
Đổi kích thước sang kích thước tùy chỉnh:
curl -X POST http://localhost:1349/api/v1/tools/video/resize-video \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@clip.mp4" \
-F 'settings={"width": 1280, "height": 720}'
Example Response
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
"originalSize": 25000000,
"processedSize": 8500000
}
Notes
- Các giá trị preset ánh xạ tới các chiều cao chuẩn (ví dụ
720p= 1280x720,1080p= 1920x1080). Chiều rộng đổi tỷ lệ theo tỷ lệ khung hình của nguồn. - Kích thước được làm tròn thành số chẵn theo yêu cầu của hầu hết các codec video.
- Độ phân giải tối đa được hỗ trợ là 7680x4320 (8K UHD).