يوضّح لك دليل البدء السريع هذا كيفية تثبيت المكتبات وتقديم طلبك الأول باستخدام Gemini API.
قبل البدء
يجب توفّر مفتاح واجهة برمجة التطبيقات في Gemini. إذا لم يكن لديك حساب، يمكنك الحصول عليه مجانًا في Google AI Studio.
تثبيت حزمة تطوير البرامج (SDK) لتكنولوجيات الذكاء الاصطناعي التوليدي من Google
باستخدام Python 3.9 والإصدارات الأحدث، ثبِّت
حزمة google-genai
باستخدام
أمر pip التالي:
pip install -q -U google-genai
باستخدام الإصدار 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
- لإنشاء مشروع جديد في Apps Script، انتقِل إلى script.new.
- انقر على مشروع بلا عنوان.
- أعِد تسمية مشروع Apps Script AI Studio وانقر على إعادة التسمية.
- ضبط مفتاح واجهة برمجة التطبيقات
- على يمين الصفحة، انقر على إعدادات المشروع
.
- ضمن خصائص النصوص البرمجية، انقر على إضافة خاصية نص برمجي.
- بالنسبة إلى الموقع، أدخِل اسم المفتاح:
GEMINI_API_KEY
. - في حقل القيمة، أدخِل قيمة مفتاح واجهة برمجة التطبيقات.
- انقر على حفظ مواقع النصوص البرمجية.
- على يمين الصفحة، انقر على إعدادات المشروع
- استبدِل محتويات ملف
Code.gs
بالرمز التالي:
تقديم طلبك الأول
استخدِم الطريقة
generateContent
لإرسال طلب إلى Gemini API.
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)
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())
}
// 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);
}
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: