# التفريغ النصي على الجهاز والسحابي

> مصدرا التفريغ النصي المتاحان في كل مشروع، وما الذي يرسله كل منهما بالضبط، ولماذا يبقى مزود المونتاج اختيارا منفصلا.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026
> https://www.roughcuteditor.com/ar/docs/transcription-options

يحمل كل مشروع خيار «التفريغ النصي» بخيارين اثنين. «على الجهاز» هو الافتراضي: يعمل Whisper على جهاز Mac لديك، ولا يُرفع شيء من أجل التفريغ، ولا تُحتسب أي فوترة استخدام API للتفريغ، لكنه يتطلب تثبيت نموذج التعرف على الكلام المحلي. أما «سحابي (OpenAI)» فخيار ضمن Pro يُختار لكل مشروع على حدة، وهو يرسل صوت ذلك المشروع، وصوته وحده، إلى OpenAI باستخدام مفتاح API الخاص بك، على هيئة أجزاء أحادية القناة بتردد 16 kHz مقسّمة عند حدود الصمت؛ وملف الفيديو لا يُرفع إطلاقا، ولا يلزم نموذج محلي، وتحاسبك OpenAI على مفتاحك. ويجب أن يعيد كلا المسارين طوابع زمنية على مستوى الكلمة، لأن خطة القص وتصدير SRT يُبنيان على توقيتات الكلمات. ومصدر التفريغ مستقل عن مزود الذكاء الاصطناعي الذي يشغّل مرحلة المونتاج.

## عنصر التحكم

«التفريغ النصي» عنصر بخيارين، وهو موجود على شاشتي «إنشاء مونتاج أولي» و«تفريغ نصي فقط». وهو اختيار **لكل مشروع على حدة**، لا وضع عام تشغّله مرة واحدة.

| الخيار | الافتراضي | ضمن `Pro` | يحتاج إلى النموذج المحلي | يحتاج إلى مفتاح OpenAI |
|---|---|---|---|---|
| «على الجهاز» | نعم | لا | نعم | لا |
| «✦ سحابي (OpenAI)» | لا | **نعم** | لا | **نعم** |

وعند تحديد «✦ سحابي (OpenAI)»، تظهر شارة `PRO` إلى جانب تسمية «التفريغ النصي». واختياره من دون اشتراك `Pro` يفتح صفحة الاشتراك ويترك الاختيار على «على الجهاز».

## التفريغ النصي على الجهاز

هذا هو الخيار الافتراضي، وهو المسار الذي صُمم التطبيق حوله.

> يتم التفريغ على جهاز Mac هذا باستخدام Whisper، بصورة خاصة، من دون رفع أي شيء ومن دون استهلاك API. هذا هو الخيار الافتراضي.

وما يعنيه ذلك عمليا:

- يُنتج النص المفرغ نموذج كلام من Whisper يعمل محليا على جهاز Mac لديك، مع تسريع Metal على معالجات Apple Silicon.
- **لا يُرفع أي شيء من أجل التفريغ في هذا المسار.** فيبقى صوتك وفيديوك كلاهما في مكانهما.
- **ولا توجد أي فوترة API للتفريغ**، من أي جهة. فالتفريغ المحلي لا يكلف شيئا لكل دقيقة.
- ويتطلب تثبيت نموذج التعرف على الكلام، وهو تنزيل يجري مرة واحدة بحجم `1.6 GB` تقريبا ويُخزَّن على جهاز Mac لديك. راجع [تثبيت نموذج التعرف على الكلام المحلي](/ar/docs/speech-model). وإلى أن يصبح موجودا، يبقى زر «بدء المعالجة» معطّلا وتخبرك الشاشة بالسبب.
- كما يشغّل المسار المحلي حمايتين لا يستطيع المسار السحابي تشغيلهما: التفريغ المقيّد بمناطق الكلام، واستعادة المقاطع عند دخول النموذج في حلقة هلوسة يكرر فيها نفسه.

## التفريغ النصي السحابي (ضمن Pro)

«✦ سحابي (OpenAI)» خيار ضمن RoughCut Pro. وهو يحل محل التفريغ المحلي **في ذلك المشروع وحده**.

> يرسل صوت هذا المشروع إلى نموذج التفريغ النصي لدى OpenAI باستخدام مفتاحك، ولا يلزم تنزيل نموذج محلي. تحاسبك OpenAI وفقا لسعرها لكل دقيقة.

وتفاصيل الآلية بدقة:

- **الصوت وحده.** يستخرج RoughCut مسار تحليل أحادي القناة بتردد `16 kHz` ويرفع ذلك المسار. **وملف الفيديو لديك لا يُرفع إطلاقا**، لا لهذه الميزة ولا لأي ميزة أخرى.
- **صوت المشروع المحدد وحده.** لا يُضم إليه أي شيء من مشاريعك الأخرى، ولا من مكتبتك، ولا من جهاز Mac لديك.
- **مقسّم عند حدود الصمت.** يُقسَّم الصوت إلى أجزاء تبقى دون الحد الأقصى لحجم الطلب لدى OpenAI، وتقع نقاط التقسيم داخل فترات صمت مكتشفة لا في منتصف جملة. ثم تُعاد توقيتات الكلمات إلى إحداثيات الملف الكامل.
- **مفتاح API الخاص بك.** يُوثَّق الطلب بمفتاح OpenAI الذي حفظته في RoughCut، والمحفوظ في سلسلة مفاتيح macOS (`Keychain`). ولا يوجد أي خادم لـ RoughCut في هذا المسار.
- **وتحاسبك OpenAI** وفق سعرها المعلن لكل دقيقة للنموذج.
- **ولا حاجة إلى نموذج محلي.** وهذا هو السبب العملي لاستخدامه: فجهاز Mac لم ينزّل نموذج التعرف على الكلام بحجم `1.6 GB` يظل قادرا على التفريغ.

ومن دون مفتاح محفوظ، يعرض العنصر:

```text
يتطلب التفريغ النصي السحابي مفتاح OpenAI API الخاص بك.
```

مع رابط لإضافته من الإعدادات. وإن شُغّل المشروع رغم ذلك، يُفشله فحص ما قبل التشغيل بالرسالة الكاملة:

```text
يتطلب التفريغ النصي السحابي مفتاح OpenAI API. أضفه من «Settings > LLM»، أو بدّل هذا المشروع
إلى التفريغ على الجهاز.
```

وإعداد المفتاح مشروح في [إنشاء مفتاح OpenAI API وإضافته](/ar/docs/openai-api-key).

## ما الذي يخرج من جهاز Mac لديك

| المسار | ما الذي يُرسَل | إلى أين | متى |
|---|---|---|---|
| التفريغ «على الجهاز» | لا شيء | — | أبدا |
| التفريغ «✦ سحابي (OpenAI)» | **صوت** ذلك المشروع، على هيئة أجزاء أحادية القناة بتردد `16 kHz` | إلى OpenAI، بمفتاحك | فقط في المشاريع التي اخترت فيها المسار السحابي |
| مرحلة المونتاج بالذكاء الاصطناعي | **نص** التفريغ مع توقيتات الكلمات | إلى مزود الذكاء الاصطناعي الذي اخترته، بمفتاحك | فقط حين يكون «استبعاد المحاولات غير الموفقة» مفعّلا |
| تلخيص هدف الفيديو | **نص** الهدف الذي كتبته | إلى مزود الذكاء الاصطناعي الذي اخترته، بمفتاحك | فقط حين تضغط «تلخيص بالذكاء الاصطناعي» |
| ملف الفيديو لديك | لا شيء، في كل المسارات | — | أبدا |

والصورة الكاملة، بما فيها ما يُكتب على القرص ولأي مدة، موجودة في [الخصوصية وتدفق البيانات](/ar/docs/privacy-data-flow).

## كلا المسارين يجب أن يعيد طوابع زمنية على مستوى الكلمة

هذا ليس تفضيلا، بل شرط بنيوي. فـ RoughCut يبني خطة القص بمحاذاة عمليات الاستبعاد إلى حدود الكلمات، ويبني تصدير SRT من توقيتات الكلمات. والنص المفرغ الخالي من التوقيت على مستوى الكلمة لا يستطيع إنتاج أي منهما.

النموذج المحلي يعيد طوابع زمنية للكلمات. أما في الجانب السحابي، فنموذج `whisper-1` من OpenAI هو الوحيد الذي يفعل ذلك حاليا. وإن وجّهت نموذج التفريغ إلى غيره، يفشل المشروع بصوت عالٍ بدل أن ينتج بصمت مونتاجا معطوبا. وهذه الرسالة تظهر بالإنجليزية حتى عندما تعمل الواجهة بالعربية:

```text
OpenAI model '<model>' returned a transcript without word timestamps, which the cut
pipeline and SRT export require. Per OpenAI's docs only 'whisper-1' supports word
timestamps — set Settings → Full → Transcription → OpenAI transcription model to 'whisper-1'.
```

اترك «نموذج التفريغ النصي من OpenAI» على `whisper-1` ما لم تكن قد تحققت بنفسك من أن نموذجا أحدث يعيد توقيتا على مستوى الكلمة.

## مزود المونتاج إعداد مختلف

هذا الأمر يربك الناس بما يكفي ليستحق قسما خاصا به.

| الإعداد | موضعه | ما الذي يتحكم فيه |
|---|---|---|
| «التفريغ النصي» | في المشروع، إلى جانب بقية إعدادات القص | **كيف يتحول الكلام إلى نص** — محليا، أو عبر OpenAI |
| «مزود LLM» | `Settings → Basic` أو `Settings → Full → LLM` | **أي ذكاء اصطناعي يقرأ النص المفرغ** ويقترح استبعاد المحاولات غير الموفقة |

وهما مستقلان. والتوليفات الأربع كلها صالحة:

- مونتاج بـ Gemini مع تفريغ على الجهاز — وهي التهيئة الشائعة.
- مونتاج بـ Gemini مع تفريغ سحابي عبر OpenAI — أمر طبيعي تماما؛ مزودان اثنان ومفتاحان اثنان.
- مونتاج بـ OpenAI مع تفريغ على الجهاز.
- مونتاج بـ OpenAI مع تفريغ سحابي عبر OpenAI.

واختيار «✦ سحابي (OpenAI)» في مشروع ما **لا** ينقل مرحلة المونتاج لديك إلى OpenAI، وضبط «مزود LLM» على `openai` **لا** يفعّل التفريغ السحابي. راجع [اختيار مزود الذكاء الاصطناعي](/ar/docs/choose-ai-provider).

## العودة إلى «على الجهاز»

- **في مشروع بعينه:** حدد «على الجهاز» في عنصر «التفريغ النصي» قبل الضغط على «بدء المعالجة». عندئذ يُفرَّغ ذلك المشروع محليا ولا يُرفع منه شيء. ولا توجد خطوة تأكيد ولا أي غرامة.
- **لكل المشاريع المقبلة:** افتح `Settings → Full → Transcription` وعطّل «اختيار التفريغ السحابي افتراضيا». فذلك الإعداد يحدد المسار السحابي مسبقا في المشاريع الجديدة فقط، وللمشتركين في `Pro` وحدهم — ويظل كل مشروع يعرض الاختيار، ويظل كل مشروع قابلا للتبديل قبل معالجته.
- **إن انتهى اشتراكك:** تبدأ المشاريع الجديدة على «على الجهاز» تلقائيا. والمستخدمون من غير مشتركي `Pro` يبدؤون دائما على الجهاز.

والتفريغ على الجهاز يحتاج إلى نموذج التعرف على الكلام، فإن كنت قد اعتمدت المسار السحابي تحديدا لتتفادى التنزيل، فثبّت النموذج قبل أن تعود.

## أخطاء شائعة

- **افتراض أن المسار السحابي أسرع أو أفضل.** هو مقايضة مختلفة، لا ترقية. وميزته الحقيقية أنه لا يحتاج إلى النموذج المحلي.
- **افتراض أن `Pro` وحده يفعّله.** التفريغ السحابي يحتاج إلى `Pro` **و** إلى مفتاح OpenAI الخاص بك. كليهما.
- **تغيير نموذج التفريغ بعيدا عن `whisper-1`.** يفشل المشروع عند فحص الطوابع الزمنية للكلمات.
- **توقّع أن تكون شاشة «تفريغ نصي فقط» مستثناة.** فهي تعرض الخيارين نفسيهما. وإن اخترت المسار السحابي هناك، أُرسل صوت ذلك المشروع إلى OpenAI أيضا، مهما أوحى الوصف المكتوب أسفل تلك الشاشة.
- **تصديق تسمية المرحلة.** تعرض شاشة التقدم «جار تفريغ الصوت نصيا باستخدام whisper.cpp» حتى في مشروع سحابي. فالتسمية عامة، والعمل الجاري هو المصدر الذي اخترته أنت.

## حل المشكلات

| الرسالة أو العَرَض | السبب | الحل |
|---|---|---|
| «يتطلب التفريغ النصي السحابي مفتاح OpenAI API الخاص بك.» | لا يوجد مفتاح محفوظ | احفظ المفتاح في الإعدادات، أو بدّل المشروع إلى «على الجهاز» |
| تحديد «✦ سحابي (OpenAI)» لا يفعل شيئا وتظهر صفحة الاشتراك | لا يوجد اشتراك في `Pro` | استخدم «على الجهاز»، أو اشترك |
| `OpenAI cloud transcription failed (<model>): …` | مشكلة في الشبكة أو في حد المعدل أو في المفتاح | أعاد RoughCut المحاولة مرة واحدة بالفعل؛ تحقق من المفتاح ومن الاتصال، أو بدّل إلى «على الجهاز» |
| `OpenAI model '<model>' returned a transcript without word timestamps…` | نموذج التفريغ ليس `whisper-1` | أعده إلى `whisper-1` |
| «نموذج Whisper غير موجود في `<path>`. نزّله أو استورده من الإعدادات.» | «على الجهاز» محدد والنموذج غير مثبّت | ثبّت النموذج، أو اختر المسار السحابي إن كان لديك `Pro` ومفتاح |
| «لم ينتج التفريغ النصي أي كلمات، لذلك تعذر إنشاء المونتاج.» | لم يحتوِ الصوت على كلام يمكن التعرف عليه | تأكد من أنك حمّلت الملف الصحيح ومن أنه يحتوي على صوت |
