دليل مفتاح Gemini API

مفتاح Gemini API مجانًا: كيف تحصل عليه وتستخدمه في تطبيق

الحصول على مفتاح Gemini API مجانًا من Google AI Studio، ومعرفة ما تتيحه الباقة المجانية، واستخدام Gemini في تطبيق دردشة على iPhone وAndroid والويب دون برمجة.

Oriveo Teamتاريخ النشر آخر تحديث قراءة 7 دقائق
  • لاستخدام Gemini بمفتاحك الخاص دون برمجة، يلزم إنشاء مفتاح API في Google AI Studio (aistudio.google.com/apikey) ولصقه في تطبيق دردشة BYOK مثل Oriveo. عندها يُحاسَب الاستخدام، أو يُحتسب ضمن حدود الباقة المجانية، على مشروع Google Cloud الذي ينتمي إليه المفتاح.
  • لواجهة Gemini API باقة مجانية لكثير من النماذج، منها عائلة Flash، لكن قد تستخدم Google محتوى الباقة المجانية لتحسين منتجاتها، وبعض النماذج، مثل Gemini 3.1 Pro Preview، مدفوعة فقط.
  • في الباقة المدفوعة، بتاريخ 28 سبتمبر 2026، يبلغ سعر Gemini 3.8 Flash $0.75 لكل مليون رمز (token) من الإدخال و $3.75 لكل مليون رمز من الإخراج، أي أقل بكثير من سنت واحد للرسالة العادية تقديريًا.
Oriveo على iPhone: قائمة المحادثات، وإلى جانب كل محادثة تكلفتها التقديرية.

ما الفرق بين Gemini API وتطبيق Gemini

تقدّم Google نموذج Gemini بطريقتين. تطبيق Gemini، بخطته المجانية وخطط Google AI المدفوعة، منتج للاستخدام العادي. أما Gemini API فمنتج للمطورين: تنشئ مفتاح API، وتُرسل البرامج، ومنها تطبيق دردشة يقبل مفتاحك الخاص، طلبات إلى نماذج Gemini نيابةً عنك.

تُدار الـ API من Google AI Studio ويسندها مشروع Google Cloud. وتذكر وثائق Google أن كل مفتاح Gemini API مرتبط بمشروع Google Cloud، وأن المشروع هو مكان إدارة الفوترة والمتعاونين والصلاحيات. وتُطبَّق حدود الطلبات على المشروع لا على المفتاح. ويُفعَّل الاستخدام المدفوع للـ API بربط حساب فوترة في Cloud بذلك المشروع، فلا تفترض أن خطة Google AI العادية تدفع عن طلبات الـ API.

الخطوة 1: إنشاء مفتاح Gemini API

إنشاء المفتاح يستغرق دقيقة ولا يحتاج إلى بطاقة دفع للباقة المجانية. وعند أول استخدام لـ AI Studio، تُنشئ المنصة مشروع Google Cloud افتراضيًا ومفتاح API بعد الموافقة على شروط الخدمة.

  • الدخول إلى aistudio.google.com/apikey وتسجيل الدخول بحساب Google.
  • الموافقة على شروط الخدمة إن طُلبت؛ فالمستخدمون الجدد يحصلون على مشروع ومفتاح افتراضيين تلقائيًا.
  • إنشاء مفتاح API، أو نسخ المفتاح الذي أُنشئ، مع ملاحظة المشروع الذي ينتمي إليه.
  • حفظ المفتاح في مكان آمن، مثل مدير كلمات المرور. تبدأ مفاتيح Gemini عادةً بـ «AIza».

الخطوة 2: الاختيار بين الباقة المجانية والمدفوعة

هذا هو القرار الأهم مع Gemini، لأن الباقتين تختلفان في أكثر من السعر. تذكر صفحة الأسعار لكل نموذج هل الباقة المجانية «Free of charge» أم «Not available»، وتوضح أيضًا كيف يُعامَل محتواك في كل باقة.

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

وتختلف حدود الطلبات أيضًا. المشروع بلا فوترة يكون في الباقة المجانية. وربط حساب فوترة نشط ينقله إلى المستوى Tier 1، وتأتي المستويات الأعلى مع الإنفاق التراكمي بمرور الوقت. الحدود تختلف من نموذج إلى آخر، وتشير Google إلى أنها تظهر في AI Studio وتُحدَّث تلقائيًا مع تغيّر مستوى المشروع.

الخطوة 2: الاختيار بين الباقة المجانية والمدفوعة
الباقة المجانيةالباقة المدفوعة (مع ربط الفوترة)
التكلفة عن كل رمزلا شيء، للنماذج المكتوب عليها «Free of charge»أسعار منشورة لكل رمز
النماذج المتاحةنماذج كثيرة، منها Flash؛ وبعض إصدارات Pro التجريبية غير متاحةكل النماذج المدرجة
استخدام المحتوى، حسب صفحة أسعار Googleيُستخدم لتحسين منتجات Googleلا يُستخدم لتحسين منتجات Google
حدود الطلباتحدود الباقة المجانية لكل مشروعTier 1 وما فوقه، لكل مشروع

كم يكلّف Gemini في الباقة المدفوعة

يعرض الجدول أسعار Google المنشورة للباقة المدفوعة لثلاثة نماذج حالية بتاريخ 28 سبتمبر 2026، للطلبات التي لا تتجاوز 200,000 رمز، مع تكلفة تقديرية لرسالة عادية من 2,000 رمز إدخال و600 رمز إخراج. ويلفت النظر تسعير Gemini 3.8 Flash المرتبط بتاريخ: تُدرج Google $0.75 للإدخال و $3.75 للإخراج حتى 31 ديسمبر 2026، ثم $1.50 للإدخال و $7.50 للإخراج ابتداءً من 1 يناير 2027.

حساب Gemini 3.8 Flash: 2,000 × $0.75 ÷ 1,000,000 + 600 × $3.75 ÷ 1,000,000 = $0.00375، أي أقل من نصف سنت. والمحادثات الطويلة تكلّف أكثر للرسالة لأن الأدوار السابقة تُعاد كإدخال، وفاتورة Google هي المبلغ النهائي.

كم يكلّف Gemini في الباقة المدفوعة
النموذجالإدخال (USD / مليون رمز)الإخراج (USD / مليون رمز)الباقة المجانيةالتكلفة التقديرية للرسالة العادية
Gemini 2.5 Flash-Lite0.100.40Free of chargeنحو $0.0004
Gemini 3.8 Flash0.75 (1.50 من 1 يناير 2027)3.75 (7.50 من 1 يناير 2027)Free of chargeنحو $0.004
Gemini 3.1 Pro Preview2.0012.00Not availableنحو $0.011

الخطوة 3: إضافة المفتاح في Oriveo

Oriveo تطبيق دردشة متعدد النماذج على iPhone و Android والويب، يعمل بمفاتيحك أنت. Google Gemini واحد من مزوّديه الرسميين الـ 15، ضمن قسم المزوّدين المباشرين: «مزوّدو الذكاء الاصطناعي المباشرون» على iPhone وAndroid، و«ربط مباشر بمزودي AI الرسميين» على الويب. والتسميات أدناه هي ما يعرضه التطبيق بالعربية.

عند «متابعة» يتحقق Oriveo من المفتاح بأن يطلب من Google النماذج المتاحة له، ثم يزامن القائمة. والمفتاح الذي ترفضه Google يُبلَّغ عنه فورًا، فتصلحه قبل أن تبدأ الدردشة.

الخطوة 3: إضافة المفتاح في Oriveo
الخطوةiPhoneAndroidالويب
فتح قائمة المزوّدينتبويب «مزودو الخدمة»تبويب «مزودو الخدمة»«مزودو الخدمة» في الشريط الجانبي
بدء الإعدادإضافة مزوّدإضافة مزوّدإضافة مزود
اختيار المزوّدGoogle Gemini ضمن «مزوّدو الذكاء الاصطناعي المباشرون»Google Gemini ضمن «مزوّدو الذكاء الاصطناعي المباشرون»Google Gemini ضمن «ربط مباشر بمزودي AI الرسميين»
لصق المفتاححقل API Key تحت «ربط Google Gemini»حقل «مفتاح API» تحت «ربط Google Gemini»حقل المفتاح؛ والرابط «احصل على مفتاحك من Gemini» يفتح AI Studio
التأكيدمتابعةمتابعةمتابعة

الخطوة 4: اختيار نموذج وبدء الدردشة

بعد الربط تظهر نماذج Gemini في قائمة اختيار النموذج. نماذج Flash سريعة ورخيصة وتغطي أغلب الدردشة اليومية، ونماذج Pro للتفكير الأصعب والتحليل الأطول. وإذا كان مفتاحك في الباقة المجانية فالأنسب الاكتفاء بالنماذج التي تصفها صفحة الأسعار بأنها مجانية، لأن النماذج المدفوعة فقط ستعيد خطأ ما لم تُربط الفوترة.

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

أخطاء شائعة ومعناها

رسائل أخطاء Gemini محددة عادةً بما يكفي لتدل على السبب.

  • «API key not valid» (أي أن مفتاح API غير صالح): المفتاح نُسخ ناقصًا أو حُذف أو قُيّد. يُنسخ من جديد من AI Studio أو يُنشأ مفتاح جديد.
  • تجاوز الحد أو استنفاد الموارد (rate limit / resource exhausted): بلغ مشروعك حد الدقيقة أو اليوم لذلك النموذج. الحل: الانتظار، أو التحويل إلى نموذج آخر، أو ربط الفوترة للحصول على حدود أعلى.
  • نموذج غير متاح في مستواك: بعض النماذج مدفوعة فقط. الحل: ربط الفوترة بالمشروع أو اختيار نموذج مجاني.
  • عدة مفاتيح تبلغ الحدود معًا: الحدود لكل مشروع، فالمفاتيح داخل المشروع الواحد تتقاسمها.

حماية مفتاحك

مفتاح Gemini قد ينفق مالًا بمجرد ربط الفوترة، وقد يستنفد حصتك المجانية قبل ذلك. يحتفظ Oriveo بمفاتيح المزوّدين على جهازك أو في متصفحك، لا كسجلات في الحساب. تطبيقا iPhone و Android يرسلان الطلبات إلى Google مباشرة، أما تطبيق الويب فيرسلها عبر تمرير لحظي على خادم Oriveo: يُستخدم مفتاحك لذلك الطلب فقط ولا يُحفظ كسجل في الحساب، ولا تُخزَّن محادثات BYOK كسجلات دردشة. ولا يضيف Oriveo أي هامش على أسعار Google.

الأفضل استخدام مشروع أو مفتاح مخصص لتطبيق الدردشة، ومراجعة الاستخدام في AI Studio ولوحة Cloud، وحذف أي مفتاح انكشف.

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

هل Gemini API مجانية؟
جزئيًا. لكثير من نماذج Gemini باقة مجانية بلا مقابل ضمن حدود الطلبات، لكن بعض النماذج، مثل Gemini 3.1 Pro Preview، مدفوعة فقط. وتذكر صفحة أسعار Google أيضًا أن محتوى الباقة المجانية يُستخدم لتحسين منتجاتها، بينما محتوى الباقة المدفوعة لا يُستخدم لذلك.
من أين أحصل على مفتاح Gemini API؟
من Google AI Studio على aistudio.google.com/apikey. يحصل المستخدمون الجدد على مشروع Google Cloud ومفتاح افتراضيين بعد الموافقة على الشروط. وكل مفتاح ينتمي إلى مشروع في Cloud، وهو الذي يحمل الفوترة وحدود الطلبات.
هل يغطي اشتراك Google AI Pro استخدام Gemini API؟
لا تفترض ذلك. خطط Google AI العادية تغطي تطبيق Gemini، أما استخدام Gemini API المدفوع فيُفعَّل بربط حساب فوترة في Cloud بمشروع مفتاحك. وتُراجَع فوترة مشروعك في AI Studio.
كم يكلّف Gemini بمفتاحي الخاص؟
في الباقة المدفوعة، بتاريخ 28 سبتمبر 2026، يبلغ سعر Gemini 3.8 Flash $0.75 لكل مليون رمز إدخال و $3.75 لكل مليون رمز إخراج حتى 31 ديسمبر 2026، أي نحو $0.004 للرسالة العادية تقديريًا.
هل أستطيع استخدام مفتاح Gemini API على iPhone و Android؟
نعم. في Oriveo: «مزودو الخدمة» ثم «إضافة مزوّد» ثم Google Gemini، ولصق المفتاح والضغط على «متابعة». التطبيقان الأصليان يرسلان الطلبات إلى Google مباشرة، والمفتاح نفسه يعمل أيضًا في تطبيق الويب.

قراءات ذات صلة

Gemini بمفتاحك الخاص

بإضافة مفتاح Gemini إلى Oriveo على iPhone أو Android أو الويب، تبدّل بين Gemini وأكثر من 700 نموذج آخر، وترى تكلفة تقديرية تحت كل رسالة.