البدء السريع لواجهة برمجة تطبيقات Gemini

يوضّح لك دليل البدء السريع هذا كيفية بدء استخدام واجهة برمجة التطبيقات Gemini API باستخدام حزمة SDK التي تختارها.


الاطّلاع على تكنولوجيات الذكاء الاصطناعي من Google تجربة "مفكرة Colab" عرض دفتر الملاحظات على GitHub

المتطلبات الأساسية

يفترض البدء السريع هذا أنّك على دراية بإنشاء التطبيقات باستخدام Python.

لإكمال هذا الدليل السريع، تأكَّد من أنّ بيئة التطوير تستوفي المتطلبات التالية:

  • الإصدار 3.9 من Python والإصدارات الأحدث

تثبيت حزمة تطوير البرامج (SDK) لتكنولوجيات الذكاء الاصطناعي من Google

تتضمّن حزمة تطوير البرامج (SDK) لـ Python لواجهة برمجة التطبيقات Gemini API حزمة google-generativeai. ثبِّت التبعية باستخدام pip:

pip install -q -U google-generativeai

إعداد المصادقة

إنّ أسهل طريقة للمصادقة مع Gemini API هي ضبط مفتاح واجهة برمجة التطبيقات، كما هو описан في هذا القسم. إذا كنت بحاجة إلى عناصر تحكّم أكثر صرامة في الوصول، يمكنك استخدام OAuth بدلاً من ذلك.

إذا لم يكن لديك مفتاح واجهة برمجة التطبيقات، أنشئ مفتاحًا في Google AI Studio.

الحصول على مفتاح واجهة برمجة التطبيقات من Google AI Studio

بعد ذلك، اضبط مفتاحك.

ننصحك بشدة بعدم التحقّق من مفتاح واجهة برمجة التطبيقات في نظام التحكّم في الإصدارات، ولكن يمكنك تعيينه كمتغيّر بيئة بدلاً من ذلك:

export API_KEY=<YOUR_API_KEY>

استيراد المكتبة

استورِد مكتبة الذكاء الاصطناعي التوليدي من Google واضبطها.

import google.generativeai as genai
import os

genai.configure(api_key=os.environ["API_KEY"])

تقديم طلبك الأول

استخدِم الطريقة generateContent لإنشاء نص.

model = genai.GenerativeModel("gemini-1.5-flash")
response = model.generate_content("Write a story about a magic backpack.")
print(response.text)
text_generation.py

الخطوات التالية

بعد الانتهاء من إعداد طلباتك إلى Gemini API، يمكنك استخدام مجموعة كاملة من إمكانات Gemini API لإنشاء تطبيقاتك ومسارات عملك. للبدء في استخدام ميزات Gemini API، يمكنك الاطّلاع على الأدلة التالية:

للحصول على مستندات مفصّلة عن طرق Gemini API ومَعلمات الطلبات، يُرجى الاطّلاع على الأدلة في مرجع واجهة برمجة التطبيقات.