This page was machine-translated. Spotted a mistake?Help improve it.
Skip to content

Compress Video

Giảm kích thước file video bằng cách sử dụng cường độ nén có thể cấu hình và tùy chọn giảm độ phân giải.

API Endpoint

POST /api/v1/tools/video/compress-video

Nhận multipart form data gồm một file video và một trường JSON settings. Đây là endpoint bất đồng bộ - nó trả về 202 Accepted ngay lập tức và tiến độ được truyền qua SSE tại GET /api/v1/jobs/{jobId}/progress.

Parameters

ParameterTypeRequiredDefaultDescription
qualitystringNo"balanced"Cường độ nén: light, balanced, strong
resolutionstringNo"original"Độ phân giải đầu ra: original, 1080p, 720p, 480p

Example Request

bash
curl -X POST http://localhost:1349/api/v1/tools/video/compress-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"quality": "strong", "resolution": "720p"}'

Example Response

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Notes

  • Preset light giữ chất lượng gần như gốc. Preset strong giảm kích thước file mạnh mẽ với cái giá là độ trung thực hình ảnh.
  • Giảm độ phân giải (ví dụ từ 4K xuống 720p) kết hợp với nén để giảm kích thước đáng kể.
  • Cập nhật tiến độ có sẵn qua SSE tại GET /api/v1/jobs/{jobId}/progress cho đến khi tác vụ hoàn tất.