يوضّح لك دليل البدء السريع هذا كيفية تثبيت المكتبات وتقديم طلبك الأول باستخدام Gemini API.
قبل البدء
يجب توفّر مفتاح واجهة برمجة التطبيقات في Gemini. إذا لم يكن ل��يك حساب، يمكنك الحصول عليه مجانًا في Google AI Studio.
تثبيت حزمة تطوير البرامج (SDK) لتكنولوجيات الذكاء الاصطناعي التوليدي من Google
Python
باستخدام Python 3.9 والإصدارات الأحدث، ثبِّت
حزمة google-genai
باستخدام
أمر pip التالي:
pip install -q -U google-genai
JavaScript
باستخدام الإصدار 18 من Node.js والإصدارات الأحدث، ثبِّت حزمة تطوير البرامج (SDK) لميزة "الذكاء الاصطناعي التوليدي من Google" لـ TypeScript وJavaScript باستخدام volgendأمر npm:
npm install @google/genai
انتقال
ثبِّت google.golang.org/genai في دليل الوحدة باستخدام أمر go get:
go get google.golang.org/genai
Java
إذا كنت تستخدم Maven، يمكنك تثبيت google-genai من خلال إضافة ما يلي إلى التبعيات:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
برمجة تطبيقات
- لإنشاء مشروع جديد في Apps Script، انتقِل إلى script.new.
- انقر على مشروع بلا عنوان.
- أعِد تسمية مشروع Apps Script AI Studio وانقر على إعادة التسمية.
- ضبط مفتاح واجهة برمجة التطبيقات
- على يمين الصفحة، انقر على إعدادات المشروع
.
- ضمن خصائص النصوص البرمجية، انقر على إضافة خاصية ��ص برمجي.
- بالنسبة إلى الموقع، أدخِل اسم المفتاح:
GEMINI_API_KEY
. - في حقل القيمة، أدخِل قيمة مفتاح واجهة برمجة التطبيقات.
- انقر على حفظ مواقع النصوص البرمجية.
- على يمين الصفحة، انقر على إعدادات المشروع
- استبدِل محتويات ملف
Code.gs
بالرمز التالي:
تقديم طلبك الأول
استخدِم الطريقة
generateContent
لإرسال طلب إلى Gemini API.
Python
from google import genai
client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(
model="gemini-2.0-flash", contents="Explain how AI works in a few words"
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
async function main() {
const response = await ai.models.generateContent({
model: "gemini-2.0-flash",
contents: "Explain how AI works in a few words",
});
console.log(response.text);
}
main();
انتقال
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
APIKey: "YOUR_API_KEY",
Backend: genai.BackendGeminiAPI,
})
if err != nil {
log.Fatal(err)
}
result, err := client.Models.GenerateContent(
ctx,
"gemini-2.0-flash",
genai.Text("Explain how AI works in a few words"),
nil,
)
if err != nil {
log.Fatal(err)
}
fmt.Println(result.Text())
}
Java
package com.example;
import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;
public class GenerateTextFromTextInput {
public static void main(String[] args) {
// The client gets the API key from the environment variable `GOOGLE_API_KEY`.
Client client = new Client();
GenerateContentResponse response =
client.models.generateContent(
"gemini-2.0-flash",
"Explain how AI works in a few words",
null);
System.out.println(response.text());
}
}
برمجة تطبيقات
// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
const payload = {
contents: [
{
parts: [
{ text: 'Explain how AI works in a few words' },
],
},
],
};
const url = `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${apiKey}`;
const options = {
method: 'POST',
contentType: 'application/json',
payload: JSON.stringify(payload)
};
const response = UrlFetchApp.fetch(url, options);
const data = JSON.parse(response);
const content = data['candidates'][0]['content']['parts'][0]['text'];
console.log(content);
}
REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [
{
"parts": [
{
"text": "Explain how AI works in a few words"
}
]
}
]
}'
الخطوات التالية
بعد إرسال طلبك الأول إلى واجهة برمجة التطبيقات، ننصحك باستكشاف المراجع التالية التي توضّح كيفية استخدام Gemini: