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

شاهد هذه الخطوة في فيديو البدء، ثم اتبع الخطوات المكتوبة أدناه:

التشغيل من 0:30 · أوبن إيه آي: لوحة التحكم4 دقائق · ترجمة عربية مدمجة

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

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

اشتراك ChatGPT Plus أو Pro أو Team لا يموّل استخدام API. فوترة API منفصلة تماما — وكذلك شراؤك لـ RoughCut، فهو لا يتضمن رصيدا لاستخدام API. وهذا هو السبب الأول لفشل مفتاح يبدو سليما.

الخطوات

1. افتح صفحة مفاتيح OpenAI API وسجّل الدخول. وفي جولة الترحيب في RoughCut زر باسم فتح منصة OpenAI يأخذك إلى الوجهة نفسها.
2. أنشئ مفتاحا سريا جديدا. تطلب النافذة اسما ومشروعا اختياريا وتاريخ انتهاء — اختر ما يناسبك؛ فالمفتاح الذي تنتهي صلاحيته يُستبدل لاحقا ببساطة (انظر أدناه). وانسخه فورا. فـ OpenAI تعرض القيمة الكاملة مرة واحدة فقط؛ وإذا فقدتها، أنشئ مفتاحا آخر.
3. أعدّ فوترة API. في Platform، تتبع الفوترة المؤسسة (افتح إعدادات المؤسسة ثم صفحة الفوترة فيها) لا المشروع الذي ربما اخترته للمفتاح. أضف وسيلة دفع أو رصيدا مدفوعا مسبقا؛ ويشرح دليل OpenAI للدفع المسبق المسار الحالي.
4. في RoughCut، افتح الإعدادات. ومن تبويب أساسي (أو متقدم ثم LLM) اعثر على مفتاح OpenAI API، وألصق القيمة، ثم اضغط زر حفظ الخاص به. يؤكد RoughCut أن المفتاح حُفظ في Keychain. وهذا الزر يحفظ المفتاح وحده.
5. للمونتاج بالذكاء الاصطناعي على OpenAI: يكون مزود LLM مضبوطا على openai أصلا في التثبيت الجديد. وإذا كنت قد اخترت Gemini أو Claude من قبل، فاضبطه على openai واضغط حفظ الإعدادات أعلى النافذة — فاختيار المزود لا يُحفظ بزر حفظ الخاص بالمفتاح.
6. اختر نموذجا إن أردت: بجوار نموذج OpenAI، يعرض اختيار نموذج وتقدير التكلفة… النماذج التي يصل إليها مفتاحك ويقدّر تكلفة المشروع. الافتراضي gpt-5.6-sol باستدلال متوسط، وGPT-6 Astra ترقية اختيارية. وفي النافذة نفسها منتقي مستوى الاستدلال للنموذج المحدد؛ والخيار الافتراضي (medium) يُبقي إعداد RoughCut المختبَر، والمستويات الأعلى أبطأ وأعلى تكلفة. استخدام النموذج يملأ النموذج والمستوى؛ وحفظ الإعدادات يطبّقهما.
7. للتفريغ النصي السحابي (Pro): اترك المزود على ما تشاء، واختر بدلا من ذلك ✦ سحابي (OpenAI) من عنصر التحكم التفريغ النصي في المشروع. فالإعدادان مستقلان.
8. اختبر بمقطع قصير قبل أن تدفع بتسجيل طويل إلى المعالجة.

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

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

عند انتهاء صلاحية المفتاح أو إلغائه

المفتاح المنتهي أو الملغى لا يظهر كخطأ حتى يستخدمه RoughCut. فأول مشروع يصل بعد ذلك إلى مرحلة الذكاء الاصطناعي يفشل بخطأ مصادقة يسمي OpenAI. أنشئ مفتاحا جديدا في Platform، وافتح حقل مفتاح 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 ما لم تكن قد تأكدت أن نموذجا أحدث يعيد طوابع زمنية على مستوى الكلمة.

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

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

أخطاء شائعة

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

حل المشكلات