مفتاح Gemini API مجانًا: كيف تحصل عليه وتستخدمه في تطبيق
الحصول على مفتاح Gemini API مجانًا من Google AI Studio، ومعرفة ما تتيحه الباقة المجانية، واستخدام Gemini في تطبيق دردشة على iPhone وAndroid والويب دون برمجة.
- لاستخدام 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 لكل مليون رمز من الإخراج، أي أقل بكثير من سنت واحد للرسالة العادية تقديريًا.

ما الفرق بين 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 وتُحدَّث تلقائيًا مع تغيّر مستوى المشروع.
| الباقة المجانية | الباقة المدفوعة (مع ربط الفوترة) | |
|---|---|---|
| التكلفة عن كل رمز | لا شيء، للنماذج المكتوب عليها «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 هي المبلغ النهائي.
| النموذج | الإدخال (USD / مليون رمز) | الإخراج (USD / مليون رمز) | الباقة المجانية | التكلفة التقديرية للرسالة العادية |
|---|---|---|---|---|
| Gemini 2.5 Flash-Lite | 0.10 | 0.40 | Free of charge | نحو $0.0004 |
| Gemini 3.8 Flash | 0.75 (1.50 من 1 يناير 2027) | 3.75 (7.50 من 1 يناير 2027) | Free of charge | نحو $0.004 |
| Gemini 3.1 Pro Preview | 2.00 | 12.00 | Not available | نحو $0.011 |
الخطوة 3: إضافة المفتاح في Oriveo
Oriveo تطبيق دردشة متعدد النماذج على iPhone و Android والويب، يعمل بمفاتيحك أنت. Google Gemini واحد من مزوّديه الرسميين الـ 15، ضمن قسم المزوّدين المباشرين: «مزوّدو الذكاء الاصطناعي المباشرون» على iPhone وAndroid، و«ربط مباشر بمزودي AI الرسميين» على الويب. والتسميات أدناه هي ما يعرضه التطبيق بالعربية.
عند «متابعة» يتحقق Oriveo من المفتاح بأن يطلب من Google النماذج المتاحة له، ثم يزامن القائمة. والمفتاح الذي ترفضه Google يُبلَّغ عنه فورًا، فتصلحه قبل أن تبدأ الدردشة.
| الخطوة | iPhone | Android | الويب |
|---|---|---|---|
| فتح قائمة المزوّدين | تبويب «مزودو الخدمة» | تبويب «مزودو الخدمة» | «مزودو الخدمة» في الشريط الجانبي |
| بدء الإعداد | إضافة مزوّد | إضافة مزوّد | إضافة مزود |
| اختيار المزوّد | 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 API؟
هل يغطي اشتراك Google AI Pro استخدام Gemini API؟
كم يكلّف Gemini بمفتاحي الخاص؟
هل أستطيع استخدام مفتاح Gemini API على iPhone و Android؟
قراءات ذات صلة
Gemini بمفتاحك الخاص
بإضافة مفتاح Gemini إلى Oriveo على iPhone أو Android أو الويب، تبدّل بين Gemini وأكثر من 700 نموذج آخر، وترى تكلفة تقديرية تحت كل رسالة.