Gemini API: الخطة المجانية والأسعار وتربطه بشغلك إزاي

Gemini API هو الباب اللي بتدخل منه على نماذج جيميني بتاعة جوجل من الكود بتاعك، بدل ما تكتب في الشات بإيدك. بمفتاح واحد من Google AI Studio تقدر تخلي شيت يصنّف رسايل العملاء، أو موقع يكتب وصف المنتجات، أو سكريبت يقرا الفواتير المصوّرة ويطلع منها الأرقام. والسبب إن الناس بتدوّر عليه كتير إن جوجل بتدي خطة مجانية بحدود، تكفي تجرّب وتبني نموذج أولي من غير ما تدفع.
هنشرح في المقال إزاي تطلع المفتاح، وإيه حدود الخطة المجانية والحاجة اللي لازم تعرفها عن خصوصية بياناتك فيها، وإزاي تحسب التكلفة لما تدفع، وأمثلة كود جاهزة بـ Python وبـ Google Apps Script، وإمتى يكون أنسب من ChatGPT API أو Claude.
محتويات المقال
إزاي تطلع مفتاح Gemini API من Google AI Studio
الخطوات بسيطة ومش محتاجة كارت في البداية:
- ادخل على Google AI Studio بحساب جوجل بتاعك.
- من القائمة اختار Get API key، وبعدين Create API key.
- اختار مشروع Google Cloud موجود أو سيبه يعمل مشروع جديد.
- انسخ المفتاح واحفظه في مكان آمن، زي مدير باسوردات أو ملف إعدادات برة الكود.
جوه AI Studio نفسه فيه مساحة تجرّب فيها البرومبت على النماذج المختلفة قبل ما تكتب أي كود. استغلها: جرّب نفس الطلب على أكتر من نموذج، وشوف أنهي واحد بيرد أحسن بالعربي، وبعدين انقل الإعدادات للكود.
تحذير مهم: المفتاح ده زي باسورد حسابك. ما تحطوش في كود الموقع اللي بيتحمّل في متصفح الزائر، وما ترفعوش على GitHub. أي حد معاه المفتاح يقدر يستخدم رصيدك أو حدودك.
الخطة المجانية في Gemini API: الحدود والخصوصية
جوجل بتقسم الاستخدام لطبقتين: مجانية ومدفوعة. الطبقة المجانية ليها حدود على عدد الطلبات في الدقيقة وفي اليوم، والحدود دي بتختلف من نموذج للتاني وبتتغير كل فترة، فشوف الأرقام الحالية في صفحة الحدود جوه AI Studio. للتجربة وبناء نموذج أولي أو أداة داخلية صغيرة، الطبقة المجانية غالبًا بتكفي.
| الطبقة المجانية | الطبقة المدفوعة | |
|---|---|---|
| التكلفة | صفر | حسب التوكنز |
| عدد الطلبات | محدود في الدقيقة واليوم | أعلى بكتير |
| استخدام بياناتك لتحسين المنتجات | ممكن، حسب شروط جوجل | لأ، حسب شروط جوجل |
| مناسبة لـ | التجربة والأدوات الصغيرة | بيانات العملاء والإنتاج |
السطر التالت هو الأهم وأغلب الناس بتعدّيه. شروط جوجل بتقول إن المحتوى اللي بيتبعت في الطبقة المجانية ممكن يتستخدم لتحسين منتجاتها، وممكن يراجعه بشر. يعني ما تبعتش فيها بيانات عملاء حقيقية، ولا أرقام تليفونات، ولا عقود، ولا أي حاجة سرية. أول ما تشتغل على بيانات حقيقية، فعّل الدفع على المشروع. ولو عندك عملاء في السعودية أو أوروبا، دي مش مجرد نصيحة، دي جزء من التزامك بقوانين حماية البيانات.
أسعار Gemini API بعد الخطة المجانية
التسعير بالتوكنز، والتوكن تقريبًا جزء من كلمة. الطلب الواحد ليه جزئين:
- المدخلات: البرومبت بتاعك والنص أو الصورة اللي بتبعتها.
- المخرجات: الرد اللي النموذج بيكتبه، وغالبًا سعره أعلى من المدخلات.
النماذج السريعة الخفيفة (اللي اسمها فيه Flash أو Lite) أرخص بكتير، وبتكفي أغلب مهام البيزنس: تصنيف رسالة، تلخيص، استخراج بيانات من نص. النماذج الأقوى (اللي فيها Pro) للمهام اللي محتاجة تفكير أعمق أو نصوص طويلة. ابدأ دايمًا بالنموذج الأرخص، ولو النتيجة مش كفاية انقل للأقوى.
مثال تقدير تكلفة
متجر بيجيله 3,000 رسالة في الشهر، وعايز يصنّف كل رسالة. الرسالة مع البرومبت تقريبًا 150 كلمة، يعني حوالي 200 إلى 300 توكن مدخلات، والرد كلمة واحدة، يعني توكنات مخرجات قليلة جدًا. المجموع في الشهر أقل من مليون توكن مدخلات. على نموذج Flash، ده غالبًا رقم صغير جدًا مقارنة بمرتب ساعة واحدة من موظف بيقرا الرسايل ويصنفها بإيده. اضرب الأرقام دي في الأسعار الحالية من صفحة الأسعار، وهتعرف التكلفة قبل ما تكتب سطر كود. اللي بيرفع الفاتورة فعلًا: إنك تبعت تاريخ المحادثة كله مع كل طلب، أو تطلب ردود طويلة مش محتاجها، أو تستخدم النموذج الأقوى في مهمة بسيطة.
نفس منطق الحساب ده شرحته بالتفصيل في ChatGPT API، وبينطبق هنا: احسب متوسط حجم الطلب، اضربه في عدد الطلبات في الشهر، وحط حد للصرف من إعدادات الفوترة في Google Cloud علشان ما تتفاجئش. ولو مش عارف التوكنز بتتحسب إزاي أصلًا، اقرا النماذج اللغوية الكبيرة LLM.
أول طلب بـ Gemini API بلغة Python
ثبّت مكتبة جوجل الرسمية:
pip install google-genaiوحط المفتاح في متغير بيئة اسمه GEMINI_API_KEY بدل ما تكتبه في الكود. وبعدين:
from google import genai
client = genai.Client() # بيقرا GEMINI_API_KEY لوحده
msg = "المنتج وصلني مكسور وعايز أرجعه، ومحدش بيرد على التليفون"
prompt = (
"صنّف رسالة العميل دي لنوع واحد من: شكوى، استفسار، طلب شراء، إرجاع. "
"ورد بكلمة واحدة بس.\n\n" + msg
)
res = client.models.generate_content(model="gemini-2.5-flash", contents=prompt)
print(res.text)اسم النموذج بيتغير مع كل إصدار جديد، فخد الاسم الحالي من قائمة النماذج في AI Studio. والفكرة في المثال إن الرد كلمة واحدة، فتقدر تستخدمه مباشرة في الكود: لو “إرجاع” ابعت الرسالة لفريق المرتجعات، ولو “طلب شراء” ابعتها للمبيعات.
تربط Gemini API بجوجل شيت بـ Apps Script
ده أسرع طريق لأي حد شغله على جوجل شيت، ومش محتاج سيرفر ولا Python. من الشيت: Extensions ثم Apps Script، والصق الكود ده:
function GEMINI(text) {
const key = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent';
const body = { contents: [{ parts: [{ text: 'لخّص الرأي ده في 5 كلمات: ' + text }] }] };
const res = UrlFetchApp.fetch(url, {
method: 'post',
contentType: 'application/json',
headers: { 'x-goog-api-key': key },
payload: JSON.stringify(body)
});
return JSON.parse(res.getContentText()).candidates[0].content.parts[0].text;
}حط المفتاح في Project Settings ثم Script Properties باسم GEMINI_API_KEY. بعدها في أي خلية تكتب =GEMINI(A2) فتاخد ملخص الرأي اللي في A2. ولو عندك عمود فيه 500 رأي عميل، اسحب المعادلة لتحت، بس خد بالك من حدود الطلبات في الدقيقة، ولو العدد كبير خليها دالة بتشتغل على دفعات بدل معادلة في كل خلية.
لو أول مرة تتعامل مع Apps Script، ابدأ من Google Apps Script للمسوّقين، ولو عايز السكريبت يشتغل لوحده كل يوم، شوف المشغلات Triggers في Apps Script.
استخدامات عملية لـ Gemini API في البيزنس
- تحليل آراء العملاء: تجمع التعليقات والتقييمات وتطلع منها المشاكل المتكررة وزوايا إعلان، زي اللي في تحليل آراء العملاء بالذكاء الاصطناعي.
- قراية الصور والفواتير: جيميني بيفهم الصور، فتقدر تبعتله صورة إيصال وتطلب الإجمالي والتاريخ واسم المورد. الطريقة الكاملة في استخراج النص من الصورة.
- تفريغ الصوت: الفويسات والمكالمات لنص، زي ما في تحويل الصوت إلى نص.
- وصف المنتجات: من مواصفات خام لوصف مرتب، بس راجعه قبل النشر.
- فرز الرسايل: تصنيف الرسايل الجاية من الموقع أو الواتساب وتوجيهها للشخص المناسب.
- تقارير الإعلانات: تلخيص أرقام الأسبوع بلغة بسيطة للعميل أو للمدير.
مثال كامل: فرز رسايل فورم الموقع
خلينا ناخد مثال من أوله لآخره. شركة خدمات بيجيلها رسايل من فورم الموقع، وكلها بتروح لإيميل واحد، وفيها طلبات عروض أسعار وشكاوى وناس بتدوّر على شغل وإعلانات سبام. الحل:
- الفورم يبعت كل رسالة لشيت، بالطريقة اللي في ربط فورم الموقع بـ Google Sheets.
- سكريبت Apps Script بيشتغل كل 10 دقايق، ياخد الرسايل الجديدة بس، ويبعت كل واحدة لـ Gemini API ويطلب تصنيف من 4 أنواع، ومعاه درجة استعجال من 1 لـ 3.
- السكريبت يكتب التصنيف في عمود جنب الرسالة.
- لو التصنيف “طلب عرض سعر” والاستعجال 3، يبعت تنبيه فوري لمسؤول المبيعات على تليجرام، زي اللي في تنبيهات تليجرام من Google Sheets.
النتيجة إن طلب العرض المهم بيوصل لصاحبه في دقايق بدل ما يستنى لحد ما حد يفتح الإيميل، والسبام بيتشال من الطريق. وكل ده بتكلفة شهرية صغيرة جدًا، وأحيانًا من غير تكلفة لو العدد صغير، بشرط تلتزم بفقرة الخصوصية فوق.
في كل الحالات دي، اللي بيفرق النتيجة هو البرومبت: طلب محدد، وشكل رد ثابت، وأمثلة. ولو عايز أمثلة برومبتات جاهزة، عندك 25 برومبت تسويق.
Gemini API ولا ChatGPT API ولا Claude API؟
الثلاثة بيعملوا نفس الفكرة، والفرق في التفاصيل:
- Gemini API: ميزته الخطة المجانية للتجربة، والتكامل الطبيعي مع أدوات جوجل، وفهم الصور والصوت والفيديو، ونوافذ سياق طويلة.
- ChatGPT API: أدوات كتير جاهزة حواليه ومكتبات منتشرة، ومعروف في أغلب المنصات.
- Claude API: قوي في الكتابة والتحليل والالتزام بالتعليمات الطويلة.
النصيحة العملية: ما تتعلقش بواحد. اكتب الكود بحيث تغيّر المزود من مكان واحد، وجرّب نفس المهمة على الاتنين أو التلاتة ببيانات حقيقية، وقرّر على أساس النتيجة والتكلفة. مقارنة الاستخدام العام في التسويق موجودة في ChatGPT ولا Gemini ولا Claude.
ولو مش عايز تكتب كود خالص، تقدر توصل Gemini بأداة زي n8n من غير برمجة، بس هتدفع اشتراكها أو تستضيفها بنفسك.
أخطاء شائعة مع Gemini API
- المفتاح جوه كود الواجهة: أي حد يفتح كود الصفحة ياخده. خلي الطلب يعدي على سيرفرك أو Apps Script.
- بيانات حقيقية على الخطة المجانية: راجع فقرة الخصوصية فوق.
- مفيش حد للصرف: حلقة تكرار غلط ممكن تبعت آلاف الطلبات في دقايق.
- الثقة في الرد من غير مراجعة: النموذج ممكن يخترع رقم أو معلومة. اطلب منه يرد من النص اللي إنت باعته بس.
- برومبت مفتوح: “حلل الرسالة دي” بيطلع رد مختلف كل مرة. حدد شكل الرد بالظبط.
- تجاهل حدود الطلبات: لو بتبعت طلبات كتير ورا بعض، هتاخد أخطاء 429. حط انتظار بسيط بين الطلبات أو اشتغل على دفعات.
- عدم تسجيل الأخطاء: لو السكريبت فشل في طلب، سجّل الرسالة والخطأ في شيت منفصل علشان تعيدها بعدين بدل ما تضيع.
كمّل القراءة: Claude API: تبدأ إزاي وتكلفته كام وتستخدمه في إيه.
أسئلة شائعة
Gemini API مجاني؟
فيه طبقة مجانية بحدود على عدد الطلبات، تكفي التجربة والأدوات الصغيرة. للاستخدام الكبير أو مع بيانات عملاء حقيقية، الأفضل تفعّل الدفع.
أطلع مفتاح Gemini API منين؟
من Google AI Studio: Get API key ثم Create API key، وبيتربط بمشروع على Google Cloud.
بياناتي في الخطة المجانية آمنة؟
حسب شروط جوجل، المحتوى في الطبقة المجانية ممكن يتستخدم لتحسين منتجاتها. فما تبعتش فيها بيانات سرية أو بيانات عملاء.
ينفع أستخدم Gemini API من غير برمجة؟
ينفع عن طريق أدوات زي n8n أو Make، أو دالة صغيرة في جوجل شيت زي اللي في المقال، ودي أقرب حاجة لعدم البرمجة.
إيه الفرق بين Gemini API وVertex AI؟
الاتنين بيوصلوك لنفس عيلة النماذج. Gemini API عن طريق AI Studio أسهل وأسرع في البداية، ومناسب لأغلب الفريلانسرز والشركات الصغيرة. Vertex AI جوه Google Cloud، ومعمول للشركات اللي محتاجة تحكم أكبر في الصلاحيات ومكان تخزين البيانات والربط بخدمات جوجل كلاود التانية. لو مش عارف تختار، ابدأ بـ AI Studio، وانقل لـ Vertex لما تحتاج.
Gemini API بيفهم العربي كويس؟
أيوه، بيفهم العربي الفصحى والعامية بشكل كويس. بس جرّب على بياناتك الحقيقية الأول، خصوصًا لو فيها لهجات أو كلمات خاصة بمجالك.
لو عايز تربط الذكاء الاصطناعي بشغلك فعلًا، سواء تصنيف رسايل أو قراية فواتير أو تقارير، ومش متأكد تبدأ بأنهي نموذج وإزاي تحسب تكلفته، شوف خدمة أتمتة الأعمال أو ابعتلي اللي عايز تعمله: احجز استشارة.