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

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

التشغيل من 1:10 · جيميناي: افتح استوديو جوجل4 دقائق · ترجمة عربية مدمجة

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

• حساب Google.
• وسيلة دفع تقبل ربطها بمشروع على Google Cloud.
• تثبيت RoughCut. ولا تحتاج نموذج التعرف على الكلام في هذه الخطوة.

تتحكم Google بهذا المسار وتغيّره من حين إلى آخر. والخطوات أدناه تصف شكل العملية الحالي؛ فإذا وجدت زرا باسم مختلف، اتبع الإجراء المكافئ بدل البحث عن النص الحرفي. ووثائق Google عن مفاتيح API وعن الفوترة هي المرجع.

الخطوات

1. افتح صفحة مفاتيح API في Google AI Studio وسجّل الدخول. وتذكر جولة الترحيب في RoughCut منصة Google AI Studio أيضا، في السطر الذي يبدأ بـ تفضّل Gemini أو Claude؟ في صفحة المفتاح.
2. أنشئ مفتاح API. وسينشئ AI Studio مشروع Google Cloud نيابة عنك، أو يطلب منك اختيار مشروع قائم. ولاحظ المشروع الذي يتبعه المفتاح — فمحدد المشروع يعرضه، وقائمة المفاتيح وحدها قد تضلّلك حين يكون لديك عدة مشاريع.
3. فعّل الفوترة على ذلك المشروع وأضف وسيلة دفع. يعرض إعداد الفوترة لدى Google لواجهة Gemini API حاليا رصيدا مدفوعا مسبقا أو ربط حساب فوترة؛ وفي الحالتين يجب أن يكون على المشروع الذي يملك المفتاح. فنموذج Gemini الافتراضي في RoughCut ضمن الفئة المدفوعة لدى Google، ومفتاح بلا فوترة سيفشل عند تشغيل مرحلة المونتاج. وهذه هي الخطوة التي يتجاوزها الناس أكثر من غيرها. واشتراك تطبيق Gemini لا يموّل استخدام API.
4. انسخ المفتاح.
5. في RoughCut، افتح الإعدادات. ومن تبويب أساسي (أو متقدم ثم LLM) اعثر على مفتاح Gemini API.
6. ألصق المفتاح في الحقل واضغط زر حفظ الخاص به. يؤكد RoughCut بالرسالة تم حفظ مفتاح Gemini API في Keychain. وهذا الزر يحفظ المفتاح وحده.
7. اضبط مزود LLM على gemini واضغط حفظ الإعدادات أعلى النافذة. OpenAI هو الافتراضي للتثبيتات الجديدة؛ وإذا كنت قد اخترت Gemini في إصدار سابق، فقد حُفظ اختيارك وهذه الخطوة منجزة بالفعل.
8. خطوة اختيارية: بجوار نموذج Gemini اضغط اختيار نموذج وتقدير التكلفة… ثم تحديث النماذج لعرض نماذج Gemini التي يصل إليها مفتاحك. ولا يتيح RoughCut ضبط مستوى الاستدلال في Gemini، لذا يعرض المنتقي مستوى الاستدلال مع العبارة غير قابل للتعديل في هذا النموذج. اضغط استخدام النموذج، ثم حفظ الإعدادات.
9. اختبره: أنشئ مشروعا قصيرا مع تفعيل استبعاد المحاولات غير الموفقة. فإذا كان المفتاح والفوترة سليمين، يكتمل المشروع وتعرض قائمة المراجعة ملخص محرر يسمي المزود والنموذج.

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

يعرض حقل مفتاح Gemini API تأكيدا أخضر والقيمة مخفية، مع العبارة محفوظ في Keychain وزري استبدال... واستبعاد. ويعرض مزود LLM القيمة gemini. ويكتمل مشروع الاختبار بعمليات استبعاد مقترحة من الذكاء الاصطناعي بدل نتيجة تعتمد على الصمت وحده.

ملاحظة عن الخصوصية والتكلفة

يُحفظ المفتاح في Keychain على macOS، مشفرا بواسطة النظام، ولا يُرسل إلا إلى Google. ولا توجد لـ RoughCut خوادم في هذا المسار، ولا يرى استخدامك ولا فاتورتك أبدا.

وتحاسبك Google على مفتاحك وفق أسعارها المعلنة. والتسجيلات الطويلة أعلى تكلفة، والمراجعة الثانية تضيف استدعاء آخر. ولا ينشر RoughCut رقما لكل فيديو لأن الأسعار وخيارات النماذج تتغير؛ ويعرض اختيار نموذج وتقدير التكلفة… بجوار نموذج Gemini النماذج التي يصل إليها مفتاحك ويتيح لك تقدير مشروع بافتراضاتك أنت.

إدارة المفتاح وتبديله

• استبدال... يضع مفتاحا جديدا مكان القديم من دون كشف القديم.
• استبعاد يحذف المفتاح من Keychain. وعندها يتصرف RoughCut كأنه بلا مفتاح: يظل المونتاج المعتمد على الصمت وحده يعمل، بينما يفشل استبعاد المحاولات غير الموفقة في الفحص المسبق برسالة تطلب منك إضافة مفتاح أو تعطيل الميزة.
• وإذا تسرب مفتاح يوما ما، أو أبلغت Google أنه أُلغي، ألغِه من Google AI Studio وأنشئ غيره. التبديل يستغرق ثوانٍ ولا شيء يحتاج ترحيلا.

أخطاء شائعة

• إنشاء المفتاح دون تفعيل الفوترة. يوجد المفتاح ويبدو سليما، ثم تفشل مرحلة المونتاج بخطأ في الحصة أو الفوترة. فعّل الفوترة على المشروع الذي يملك المفتاح.
• تفعيل الفوترة على مشروع آخر. قد ينشئ AI Studio مشروعا جديدا بصمت؛ فتحقق من محدد المشروع لا من قائمة المفاتيح وحدها، وتأكد أن الفوترة مفعّلة على المشروع صاحب المفتاح.
• حفظ المفتاح وترك المزود على OpenAI أو Claude. زر حفظ الخاص بالمفتاح يخزّن المفتاح فقط. اضبط مزود LLM على gemini واضغط حفظ الإعدادات.
• لصق مفتاح تحيط به مسافات أو علامات اقتباس. ألصق القيمة الخام وحدها.
• توقع ظهور المفتاح في ملف إعدادات. لا يظهر أبدا — فالأسرار تعيش في Keychain وحده، وتُنزع قبل كتابة الإعدادات على القرص.

حل المشكلات