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

يوضّح لك دليل البدء السريع هذا كيفية تثبيت المكتبات وتقديم طلبك الأول باستخدام 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
  1. لإنشاء مشروع جديد في Apps Script، انتقِل إلى script.new.
  2. انقر على مشروع بلا عنوان.
  3. أعِد تسمية مشروع Apps Script AI Studio وانقر على إعادة التسمية.
  4. ضبط مفتاح واجهة برمجة التطبيقات
    1. على يمين الصفحة، انقر على إعدادات المشروع رمز إعدادات المشروع.
    2. ضمن خصائص النصوص البرمجية، انقر على إضافة خاصية نص برمجي.
    3. بالنسبة إلى الموقع، أدخِل اسم المفتاح: GEMINI_API_KEY.
    4. في حقل القيمة، أدخِل قيمة مفتاح واجهة برمجة التطبيقات.
    5. انقر على حفظ مواقع النصوص البرمجية.
  5. استبدِل محتويات ملف 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: