Files
SnapOtter/apps/docs/ar/tools/video/embed-subtitles.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

1.9 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
دمج مسار ترجمة داخل حاوية الفيديو. be272730fff5 human decbcfe0e0d9

Embed Subtitles

دمج ملف ترجمة داخل حاوية الفيديو كمسار ترجمة مرن يمكن للمشاهدين تشغيله أو إيقافه.

API Endpoint

POST /api/v1/tools/video/embed-subtitles

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

Parameters

Parameter Type Required Default Description
language string No "eng" رمز لغة ISO 639-2/B (3 أحرف صغيرة، مثل "eng" أو "fra" أو "deu")

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/embed-subtitles \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F "file=@subtitles.srt" \
  -F 'settings={"language": "fra"}'

Example Response

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

Notes

  • ارفع ملفين: يجب أن يكون الأول فيديو، ويجب أن يكون الثاني ملف ترجمة (.srt أو .vtt أو .ass).
  • يمكن للمشاهد تبديل الترجمات المدمجة (المرنة) في مشغل الوسائط الخاص به. للحصول على ترجمات ظاهرة بشكل دائم، استخدم أداة Burn Subtitles بدلاً من ذلك.
  • يُخزَّن رمز اللغة كبيانات وصفية في الحاوية ويساعد مشغلات الوسائط على تصنيف مسار الترجمة.