Trim Video

Cắt một clip ra khỏi video bằng cách chỉ định thời điểm bắt đầu và kết thúc tính bằng giây, với tùy chọn cắt chính xác theo khung hình.

API Endpoint

POST /api/v1/tools/video/trim-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
startS	number	No	0	Thời điểm bắt đầu tính bằng giây (phải >= 0)
endS	number	Yes	-	Thời điểm kết thúc tính bằng giây (phải sau startS)
precise	boolean	No	false	Mã hóa lại để cắt chính xác theo khung hình thay vì tua theo keyframe

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/trim-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"startS": 5, "endS": 30, "precise": true}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 12500000,
  "processedSize": 4200000
}

Notes

• Khi precise là false (mặc định), công cụ dùng cách tua theo keyframe, vốn nhanh nhưng có thể bắt đầu sớm hơn thời điểm yêu cầu vài khung hình.
• Đặt precise thành true sẽ mã hóa lại đoạn để có ranh giới khung hình chính xác, nhưng mất nhiều thời gian hơn.
• Giá trị endS phải lớn hơn startS.