عايز تبني تطبيق ذكي يستخدم قوة Gemini؟ الـ API بتاعه سهل ومجاني للبداية. خلينا نمشي من أول الحصول على مفتاح لحد أول تطبيق شغّال.
الحصول على مفتاح API
روح على aistudio.google.com وسجل بحساب جوجل. اضغط على «Get API Key» في الشريط الجانبي واختار «Create API key».
مهم: احفظ المفتاح في مكان آمن — ما تحطوش في كود عام أو GitHub عام.
الباقة المجانية: عندك 60 طلب في الدقيقة مع Gemini Flash — أكتر من كافي للتطوير والمشاريع الصغيرة.
الأسعار بعد كده: رخيصة جداً مقارنة بالمنافسين — تبدأ من أجزاء من السنت لكل ألف توكن.
أول طلب API مع curl
أبسط طريقة تجرب الـ API هي عبر curl في سطر الأوامر:
curl “https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY” -H “Content-Type: application/json” -d ‘{“contents”:[{“parts”:[{“text”:”اشرحلي الذكاء الاصطناعي في 3 جمل بالعربي”}]}]}’
غيّر YOUR_API_KEY بمفتاحك. حتحصل على رد JSON فيه النص المولّد.
الإعداد مع Python
ثبّت مكتبة Google الرسمية:
pip install google-generativeai
بعدها اكتب الكود الأساسي:
import google.generativeai as genai
genai.configure(api_key=”YOUR_API_KEY”)
model = genai.GenerativeModel(“gemini-2.0-flash”)response = model.generate_content(“اكتبلي 5 أفكار لمشاريع AI بسيطة”)
print(response.text)
شغّل الكود وحتحصل على 5 أفكار مشاريع مكتوبة بالعربي.
المدخلات المتعددة — Multimodal
قوة Gemini الحقيقية في إنه بيفهم نصوص وصور مع بعض (Multimodal).
import PIL.Image
img = PIL.Image.open(“receipt.jpg”)
response = model.generate_content([“استخرج كل العناصر والأسعار من الفاتورة دي”, img])
print(response.text)
ارفع صورة فاتورة وحيستخرج البيانات منها — مفيد جداً لتطبيقات المحاسبة والأرشفة.
أفكار تطبيقات: تحليل صور طبية، قراءة لوحات عربية، وصف منتجات من صورها، استخراج نص من مستندات مصورة.
البث المباشر — Streaming
بدل ما تستنى الرد كامل، تقدر تستخدم Streaming عشان النص يظهر كلمة كلمة زي ما بيحصل في ChatGPT:
response = model.generate_content(“اكتبلي مقال قصير عن مستقبل AI”, stream=True)
for chunk in response:
print(chunk.text, end=””)
ده بيحسن تجربة المستخدم كتير — بدل ما يستنى 5 ثواني، بيشوف الرد بيتكوّن قدامه.
الحدود والأسعار
الباقة المجانية: 60 طلب/دقيقة، 1500 طلب/يوم — ممتازة للتطوير والمشاريع الصغيرة.
المدفوع: يبدأ من أسعار بسيطة جداً. Gemini Flash من أرخص النماذج القوية المتاحة.
نافذة السياق: تصل لمليون توكن في Gemini 1.5 Pro — الأكبر في السوق.
نصيحة: ابدأ بـ Gemini Flash (سريع ورخيص) وانقل لـ Pro بس لما تحتاج جودة أعلى.
جرّب بنفسك
روح على Google AI Studio واحصل على مفتاح API. جرب أول طلب بـ curl أو Python. بعدها جرب ترفع صورة مع سؤال عنها وشوف قوة الـ Multimodal. الباقة المجانية كافية للتجربة.
قرمصيص للأخبار أخبار الذكاء الاصطناعي بالعربي