Files
SnapOtter/apps/docs/ar/tools/video/trim-video.md
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.1 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
قص مقطع من الفيديو بتحديد وقتي البداية والنهاية. c84481641979 human bc478479257d

Trim Video

قص مقطع من الفيديو بتحديد وقتي البداية والنهاية بالثواني، مع خيار للقص الدقيق على مستوى الإطار.

API Endpoint

POST /api/v1/tools/video/trim-video

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف فيديو وحقل JSON settings.

Parameters

Parameter Type Required Default Description
startS number No 0 وقت البداية بالثواني (يجب أن يكون >= 0)
endS number Yes - وقت النهاية بالثواني (يجب أن يكون بعد startS)
precise boolean No false إعادة الترميز للقص الدقيق على مستوى الإطار بدلاً من البحث عن الإطار المفتاحي

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/trim-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -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

  • عندما تكون precise هي false (الافتراضي)، تستخدم الأداة البحث عن الإطار المفتاحي، وهو سريع لكنه قد يبدأ قبل الوقت المطلوب ببضعة إطارات.
  • تعيين precise إلى true يعيد ترميز المقطع للحصول على حدود إطار دقيقة، لكنه يستغرق وقتاً أطول.
  • يجب أن تكون قيمة endS أكبر من startS.