Files
SnapOtter/apps/docs/ar/tools/video/convert-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.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
تحويل مقاطع الفيديو بين MP4 وMOV وWebM وAVI وMKV. 8f9e6418b1c6 human d637982bbc69

Convert Video

تحويل مقاطع الفيديو بين صيغ MP4 وMOV وWebM وAVI وMKV مع إعدادات جودة مسبقة قابلة للتهيئة.

API Endpoint

POST /api/v1/tools/video/convert-video

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف فيديو وحقل JSON settings. هذه نقطة نهاية غير متزامنة - تُرجع 202 Accepted فوراً ويُبَثّ التقدم عبر SSE على GET /api/v1/jobs/{jobId}/progress.

Parameters

Parameter Type Required Default Description
format string No "mp4" صيغة الإخراج: mp4 أو mov أو webm أو avi أو mkv
quality string No "balanced" إعداد الجودة المسبق: high أو balanced أو small

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/convert-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"format": "webm", "quality": "balanced"}'

Example Response

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

Notes

  • يُنتج إعداد الجودة المسبق high أفضل دقة صورة لكن بملفات أكبر. يضغط الإعداد المسبق small بقوة للحصول على أصغر حجم ملف.
  • يستخدم إخراج WebM ترميز VP9. يستخدم MP4 وMOV ترميز H.264. تتوفر AVI وMKV لسير العمل القديم أو الأرشفة.
  • تحديثات التقدم متاحة عبر SSE على GET /api/v1/jobs/{jobId}/progress حتى تكتمل المهمة.