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

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


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

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

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

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

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

تثبيت حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Gemini API

تتضمّن حزمة تطوير البرامج (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 ومَعلمات الطلبات، يُرجى الاطّلاع على الأدلة في مرجع واجهة برمجة التطبيقات.