# إنشاء ملف SRT أو WebVTT مع الطوابع الزمنية

> يمكنك إنشاء ملف SRT أو WebVTT من رابط فيديو مدعوم أو ملف مرفوع، وقراءة النص بتوقيته أو JSON بتوقيت الكلمات؛ اطلب كل صيغة بمعرف التفريغ نفسه.

Canonical: https://transcript1.com/ar/features/insha-malaf-srt
Language: ar
Last updated: 2026-10-19

يمكنك إنشاء ملف SRT أو WebVTT من تسجيل مرفوع أو رابط فيديو مدعوم. نقبل YouTube وX وTikTok وInstagram وFacebook وBluesky، ومقاطع Twitch وتسجيلات البث المنتهي، وDailymotion وPinterest وLinkedIn وSnapchat Spotlight. لكل مقطع بداية ونهاية؛ واقرأ التفريغ نفسه أيضا كنص بتوقيت أو JSON.

- JSON ونص وSRT وVTT من التفريغ نفسه
- بداية ونهاية لكل مقطع
- توقيت الكلمات عند توفره عبر include=words

## اختر الصيغة التي تقبلها أداة العمل

### غير الصيغة لا المهمة

أضف format=json أو text أو srt أو vtt إلى GET /v1/transcriptions/:id. الإعداد الافتراضي json؛ لا تحتاج إلى تفريغ التسجيل من جديد.

### توقيت في بداية كل سطر

استخدم format=text مع timestamps=true ليبدأ كل سطر بتوقيت على شكل [hh:mm:ss].

### ملف ترجمة نصية للمشغل أو المونتاج

تقدم srt النوع application/x-subrip، وتقدم vtt النوع text/vtt مع ترويسة WEBVTT. لكل مقطع عبارة بتوقيتها.

### توقيت أدق للكلمات عند توفره

يضيف include=words بيانات التوقيت والنص ودرجة الثقة والمتحدث. يعتمد توفرها على المصدر؛ words تساوي null في الترجمة النصية التي رفعها صانع المحتوى.

### التنزيل بصيغة أخرى لا يستهلك دقائق

الصيغ طرق مختلفة لقراءة النص المفرغ نفسه. لا نخصم دقائق إضافية عند قراءة تفريغ مكتمل مرة أخرى.

## ارجع من السطر إلى موضعه في التسجيل

اطلب نصا عاديا مع timestamps=true. وإذا طلبت تمييز المتحدثين أثناء التفريغ، تظهر تسمياتهم أيضا. تجد خيارات القراءة في [مرجع جلب التفريغ](https://transcript1.com/ar/docs/api-reference#get-a-transcription).

يناسب النص بتوقيته الملاحظات والاقتباسات التي تحتاج إلى مراجعة دون إدخال بنية ملفات الترجمة النصية في المستند. احتفظ برابط المصدر أو اسم الملف؛ التوقيت 00:12:40 وحده لا يخبر القارئ بأي تسجيل يرجع إليه.

في JSON تمثل البداية والنهاية ثواني منذ بداية التسجيل، لا ساعة اليوم أو تاريخ التسجيل. استخدم القيم نفسها للانتقال في المشغل أو حفظ مرجع في ملاحظاتك. النص المعروض أدناه مثال توضيحي للصيغة.

### format=text&timestamps=true

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text&timestamps=true" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"

[00:00:00] Place the microphone near the speaker.
[00:00:04] Record a short test before the interview.
```

## متى تختار SRT ومتى تختار WebVTT؟

يتكون SRT من عبارات مرقمة مع وقت بداية ونهاية. ويبدأ WebVTT بترويسة WEBVTT، ويعمل مع عنصر track في HTML. بعد اكتمال التفريغ اطلب format=srt أو format=vtt واحفظ الاستجابة.

اختر ما تقبله وجهتك؛ SRT شائع في برامج المونتاج ورفع الترجمة النصية، وWebVTT مناسب لمسار نصي في مشغل HTML. لا يدمج أي منهما النص داخل صورة الفيديو، ولا ينسخ تنسيق منصة اجتماعية. يتحكم المشغل أو المحرر بالشكل.

تختلف كتابة أجزاء الثانية؛ يستخدم SRT فاصلة ويستخدم WebVTT نقطة. تغيير امتداد الملف لا يحول بنيته. اطلب الصيغة المطلوبة من التفريغ المكتمل نفسه، دون استهلاك دقائق تفريغ أخرى.

### format=srt

```
1
00:00:00,000 --> 00:00:04,200
Place the microphone near the speaker.

2
00:00:04,200 --> 00:00:09,800
Record a short test before the interview.
```

## أضف بيانات الكلمات إلى JSON عند حاجتك إليها

يطلب include=words توقيت الكلمات المتاح لتظليلها أثناء التشغيل أو اختيار مقطع أدق. إذا لم يوفر المصدر هذا التوقيت، ترجع words: null. راجع [حقول الكلمات](https://transcript1.com/ar/docs/api-reference#get-a-transcription) قبل بناء الواجهة.

يقدم التفريغ من الصوت بداية الكلمة ونهايتها ودرجة الثقة. وتقدم ترجمة YouTube النصية المنشأة تلقائيا بداية الكلمة، وتستمد نهايتها من بداية التالية. أما ما رفعه صانع المحتوى على YouTube، وجميع مسارات الترجمة النصية خارج YouTube، فلا تقدم توقيت الكلمات. يظهر مصدر X بالقيمة x_captions.

وفر في واجهتك بديلا يعتمد على توقيت المقطع. ولا تعتبر حد الكلمة نقطة قص مثالية؛ استمع حوله حتى لا تقطع بداية صوت أو نفسا. ولعرض الترجمة النصية، اجمع الكلمات في عبارات سهلة القراءة وراجعها بحجم الشاشة المقصودة.

### include=words

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
```

## اختبر الملف مع النسخة النهائية من الفيديو

انتظر status=completed قبل حفظ النص أو ملف الترجمة النصية. التفريغ غير المكتمل يعيد كائن JSON يوضح حالته. إذا رفض المشغل ملف SRT، تأكد أولا أنك لم تحفظ كائن الحالة بامتداد srt.

تتبع الأوقات بداية الملف الذي أرسلته ومدته. إذا اقتطعت جزءا من وسط التسجيل، أو عدلت بدايته، فأعد ضبط الأوقات. في [إعادة استخدام المحتوى](https://transcript1.com/ar/use-cases/tahwil-alfidyu-ila-maqal)، احفظ نطاق المقطع المقترح ودع المحرر يراجع المحاذاة بعد اكتمال المونتاج.

قبل النشر افتح الملف في المشغل المقصود وشغله بالسرعة المعتادة. راجع طول السطر ووقت القراءة وطريقة إظهار المتحدثين. يوضح [دليل الترجمة النصية لإتاحة المحتوى](https://transcript1.com/ar/use-cases/muwallid-tarjama-lilfidyu) مراجعة الأصوات المهمة والسياق الذي لا ينقله التفريغ الصوتي وحده.

احتفظ بمعرف التفريغ مع بيانات الملف. إذا احتجت لاحقا إلى إنشاء ملف VTT بدلا من SRT أو قراءة توقيت الكلمات في JSON، استخدم المعرف نفسه؛ لا تنشئ مهمة جديدة.

## الأسئلة الشائعة

### كيف أحول الصوت إلى SRT؟

ارفع التسجيل، أو أرسل رابط الفيديو، ثم اطلب format=srt بعد اكتمال التفريغ. يعمل ذلك أيضا مع YouTube أو ملف MP4. ويمكنك قراءة التفريغ نفسه كملف WebVTT أو نص أو JSON.

### هل start وend بالثواني؟

نعم، في JSON تحسبان الثواني من بداية التسجيل. أما SRT وVTT فيستخدمان تنسيق الوقت المعتاد hh:mm:ss مع أجزاء الثانية.

### هل أحصل على توقيت كل كلمة من YouTube؟

في الترجمة النصية المنشأة تلقائيا تحصل على بدايات الكلمات. أما التي رفعها صانع المحتوى فتكون words فيها null. ويقدم التفريغ بالذكاء الاصطناعي البداية والنهاية ودرجة الثقة.

### هل أستطيع تنزيل الملف قبل انتهاء التفريغ؟

لا. تتوفر صيغ SRT وVTT والنص بعد اكتمال التفريغ. قبل ذلك تعيد API كائن JSON لتتمكن من متابعة الحالة.

## اقرأ أيضا

- [الترجمة النصية والإتاحة](https://transcript1.com/ar/use-cases/muwallid-tarjama-lilfidyu)
- [صفحات حلقات البودكاست](https://transcript1.com/ar/use-cases/tafrigh-podcast)
- [تمييز المتحدثين](https://transcript1.com/ar/features/tamyiz-almutahaddithin-fi-altafrigh)
- [مرجع REST API (التوثيق)](https://transcript1.com/ar/docs/api-reference)