ازاي تستخدم Gemini API لبناء تطبيقات ذكية

عايز تبني تطبيق ذكي يستخدم قوة 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. الباقة المجانية كافية للتجربة.

شاهد أيضاً

GitHub Copilot — ازاي الـ AI بيكتب كود بدالك

تخيل إنك بتكتب كود والبرنامج بيكمّل السطر بدالك — ومش بس كلمة، لا أسطر كاملة. …

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *