استخدام مفتاح 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 لكل مليون token إخراج، أي أقل بكثير من سنت واحد للرسالة العادية تقديريًا.
ما الفرق بين 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 وتتحدث تلقائيًا مع تغيّر مستواك.
| الطبقة المجانية | الطبقة المدفوعة (مع ربط الفوترة) | |
|---|---|---|
| التكلفة عن كل token | لا شيء، للنماذج المكتوب عليها «Free of charge» | أسعار منشورة لكل token |
| النماذج المتاحة | نماذج كثيرة، منها Flash؛ وبعض إصدارات Pro التجريبية غير متاحة | كل النماذج المدرجة |
| استخدام المحتوى، حسب صفحة أسعار Google | يُستخدم لتحسين منتجات Google | لا يُستخدم لتحسين منتجات Google |
| حدود الطلبات | حدود الطبقة المجانية لكل مشروع | Tier 1 وما فوقه، لكل مشروع |
كم يكلّف Gemini في الطبقة المدفوعة
يعرض الجدول أسعار Google المنشورة للطبقة المدفوعة لثلاثة نماذج حالية بتاريخ 28 سبتمبر 2026، للطلبات التي لا تتجاوز 200,000 token، مع تكلفة تقديرية لرسالة عادية من 2,000 token إدخال و600 token إخراج. ويلفت النظر تسعير 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 / مليون token) | الإخراج (USD / مليون token) | الطبقة المجانية | التكلفة التقديرية للرسالة العادية |
|---|---|---|---|---|
| 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، ضمن «ربط مباشر بمزودي AI الرسميين». والتسميات أدناه هي ما يعرضه التطبيق بالعربية.
عند «متابعة» يتحقق Oriveo من المفتاح بأن يطلب من Google النماذج المتاحة له، ثم يزامن القائمة. والمفتاح الذي ترفضه Google يُبلَّغ عنه فورًا، فتصلحه قبل أن تبدأ الدردشة.
| الخطوة | iPhone | Android | الويب |
|---|---|---|---|
| فتح قائمة المزوّدين | تبويب «المزودون» | تبويب «المزودون» | «المزودون» في الشريط الجانبي |
| بدء الإعداد | إضافة مزود | إضافة مزود | إضافة مزود |
| اختيار المزوّد | Google Gemini ضمن «ربط مباشر بمزودي AI الرسميين» | Google Gemini ضمن «ربط مباشر بمزودي AI الرسميين» | Google Gemini ضمن «ربط مباشر بمزودي AI الرسميين» |
| لصق المفتاح | حقل مفتاح API تحت «ربط Google Gemini» | حقل مفتاح API تحت «ربط Google Gemini» | حقل المفتاح؛ والرابط «احصل على مفتاحك من Google Gemini» يفتح AI Studio |
| التأكيد | متابعة | متابعة | متابعة |
الخطوة 4: اختيار نموذج وبدء الدردشة
بعد الربط تظهر نماذج Gemini في قائمة اختيار النموذج. نماذج Flash سريعة ورخيصة وتغطي أغلب الدردشة اليومية، ونماذج Pro للتفكير الأصعب والتحليل الأطول. وإذا كان مفتاحك في الطبقة المجانية فالأنسب الاكتفاء بالنماذج التي تصفها صفحة الأسعار بأنها مجانية، لأن النماذج المدفوعة فقط ستعيد خطأ ما لم تُربط الفوترة.
ويمكنك التحويل إلى نموذج آخر في منتصف المحادثة، ومنه إلى نموذج من مزوّد آخر ربطتَه، ومتابعة الحديث في السلسلة نفسها. وتظهر تحت كل رسالة تكلفة تقديرية بسعر Google المنشور؛ وفي الطبقة المجانية يبقى أن المبلغ الفعلي للنماذج المجانية صفر، وأن الحد الذي يقيّدك هو حد الطلبات.
أخطاء شائعة ومعناها
رسائل أخطاء Gemini محددة عادةً بما يكفي لتدل على السبب.
- «API key not valid»: المفتاح نُسخ ناقصًا أو حُذف أو قُيّد. يُنسخ من جديد من AI Studio أو يُنشأ مفتاح جديد.
- تجاوز الحد أو استنفاد الموارد (rate limit / resource exhausted): بلغ مشروعك حد الدقيقة أو اليوم لذلك النموذج. الحل: الانتظار، أو التحويل إلى نموذج آخر، أو ربط الفوترة للحصول على حدود أعلى.
- نموذج غير متاح في مستواك: بعض النماذج مدفوعة فقط. الحل: ربط الفوترة بالمشروع أو اختيار نموذج مجاني.
- عدة مفاتيح تبلغ الحدود معًا: الحدود لكل مشروع، فالمفاتيح داخل المشروع الواحد تتقاسمها.
حماية مفتاحك
مفتاح Gemini قد ينفق مالًا بمجرد ربط الفوترة، وقد يستنفد حصتك المجانية قبل ذلك. يحتفظ Oriveo بمفاتيح المزوّدين على جهازك أو في متصفحك، لا كسجلات في الحساب. تطبيقا iPhone و Android يرسلان الطلبات إلى Google مباشرة، أما تطبيق الويب فيستخدم نقطة تمرير لحظية لا تحتفظ بالمفتاح ولا بمحتوى محادثات 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 نموذج آخر، وترى تكلفة تقديرية تحت كل رسالة.