أنشئ مفتاح OpenAI API وأضفه

إعداد مفتاح من منصة OpenAI مع فوترة API، واستخدامه للمونتاج بالذكاء الاصطناعي أو للتفريغ النصي السحابي في Pro.

القسم: ابدأ من هنا 3 دقيقة قراءة جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026 English

يتيح لك مفتاح OpenAI تشغيل مرحلة المونتاج بالذكاء الاصطناعي على OpenAI بدل Gemini، وهو شرط لازم للتفريغ النصي السحابي في اشتراك Pro. أنشئ مفتاحا سريا على منصة OpenAI وانسخه فورا، لأن القيمة الكاملة تُعرض مرة واحدة فقط. وموّل استخدام API بشكل منفصل: فاشتراك ChatGPT لا يدفع مقابل مكالمات API، لذا أضف رصيدا مدفوعا مسبقا أو وسيلة دفع على حساب Platform. ثم ألصق المفتاح في إعدادات RoughCut حيث يُحفظ في Keychain على macOS. ويتطلب التفريغ النصي السحابي حاليا نموذج whisper-1، لأنه النموذج الذي يعيد الطوابع الزمنية على مستوى الكلمة التي تعتمد عليها خطة القص وتصدير SRT.

في هذه الصفحة

المتطلبات المسبقة

  • حساب على منصة OpenAI في platform.openai.com. وهو منفصل عن حساب ChatGPT حتى لو سجّلت الدخول بالبريد الإلكتروني نفسه.
  • وسيلة دفع أو رصيد مدفوع مسبقا على حساب Platform.
اشتراك ChatGPT Plus أو Pro أو Team لا يموّل استخدام API. فوترة API منفصلة تماما. وهذا هو السبب الأول لفشل مفتاح يبدو سليما.

الخطوات

  1. افتح صفحة مفاتيح OpenAI API وسجّل الدخول.
  2. أنشئ مفتاحا سريا جديدا وانسخه فورا. فـ OpenAI تعرض القيمة الكاملة مرة واحدة فقط؛ وإذا فقدتها، أنشئ مفتاحا آخر.
  3. أعدّ فوترة API على حساب Platform بإضافة وسيلة دفع أو رصيد مدفوع مسبقا. ويشرح دليل OpenAI للدفع المسبق المسار الحالي.
  4. في RoughCut، افتح Settings. ومن تبويب Basic (أو Full → LLM) اعثر على مفتاح OpenAI API، وألصق القيمة، ثم اضغط حفظ. يؤكد RoughCut أن المفتاح حُفظ في Keychain.
  5. للمونتاج بالذكاء الاصطناعي على OpenAI: اضبط مزود LLM على openai. وتُقسَّم النصوص الطويلة إلى أجزاء متداخلة ثم تُدمج تلقائيا، فتعمل مقاطع الفيديو الطويلة.
  6. للتفريغ النصي السحابي (Pro): اترك المزود على ما تشاء، واختر بدلا من ذلك ✦ سحابي (OpenAI) من عنصر التحكم التفريغ النصي في المشروع. فالإعدادان مستقلان.
  7. اختبر بمقطع قصير قبل أن تدفع بتسجيل طويل إلى المعالجة.

النتيجة المتوقعة

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

التفريغ النصي السحابي يحتاج whisper-1

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

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

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 ما لم تكن قد تأكدت أن نموذجا أحدث يعيد طوابع زمنية على مستوى الكلمة.

ماذا يُرسل ومتى

الميزةما يغادر جهاز Macمتى
المونتاج بالذكاء الاصطناعي على OpenAIنص التفريغ وتوقيت الكلماتفقط حين يكون استبعاد المحاولات غير الموفقة مفعّلا
التفريغ النصي السحابي (Pro)صوت ذلك المشروع، على شكل أجزاء أحادية بتردد 16 kHzفقط في المشاريع التي اخترت فيها ✦ سحابي (OpenAI)
تلخيص هدف الفيديو (Pro)نص الهدف الذي كتبتهفقط حين تضغط تلخيص بالذكاء الاصطناعي

فيديوك لا يُرفع أبدا في أي من هذه المسارات. والتفريغ النصي السحابي يرسل الصوت وحده، مقسّما عند حدود الصمت حتى لا تنقطع الأجزاء في منتصف جملة. التفاصيل الكاملة في الخصوصية وتدفق البيانات.

أخطاء شائعة

  • تمويل ChatGPT بدل API. هما رصيدان مختلفان.
  • فقدان المفتاح. القيمة الكاملة تُعرض مرة واحدة. أنشئ مفتاحا جديدا بدل البحث عن القديم.
  • تغيير نموذج التفريغ النصي. أي قيمة غير whisper-1 تُفشل المشروع حاليا عند فحص الطوابع الزمنية.
  • افتراض أن التفريغ النصي السحابي يعمل بلا Pro. فهو ميزة في Pro ويحتاج مفتاحك الخاص أيضا — والشرطان معا لازمان.

حل المشكلات

الرسالة أو العَرَضالسبب المرجحالحل
يتطلب التفريغ النصي السحابي مفتاح OpenAI API. أضفه من «Settings > LLM»، أو بدّل هذا المشروع إلى التفريغ على الجهاز.لا مفتاح محفوظاحفظ المفتاح، أو بدّل المشروع إلى على الجهاز
رصيد أو حصة غير كافيةفوترة API غير ممولةأضف رصيدا مدفوعا مسبقا أو وسيلة دفع على حساب Platform
مطلوب توثيق المؤسسةتشترط OpenAI توثيقا لمرة واحدة لهذا النموذجأكمل التوثيق على موقع OpenAI
OpenAI cloud transcription failed (<model>): …مشكلة في الشبكة أو في حدود المعدل أو في المفتاحأعاد RoughCut المحاولة مرة بالفعل؛ تحقق من المفتاح والشبكة، أو بدّل المشروع إلى التفريغ على الجهاز
تجاوز حد المعدلطلبات كثيرة على حساب جديدانتظر ثم أعد المحاولة؛ فالحدود ترتفع مع تاريخ الحساب

ما زالت المشكلة قائمة؟

تواصل مع الدعم

هل كانت هذه الصفحة مفيدة؟