Fillimi i shpejtë i API-së Gemini

Ky udhëzues i shpejtë ju tregon se si të instaloni bibliotekat tona dhe të bëni kërkesën tuaj të parë Gemini API.

Para se të filloni

Për të përdorur Gemini API, duhet të keni një çelës API për të autentifikuar kërkesat tuaja, për të zbatuar kufijtë e sigurisë dhe për të ndjekur përdorimin e llogarisë suaj.

Krijo një falas në AI Studio për të filluar:

Krijo një Çelës API Gemini

Instaloni SDK-në Google GenAI

Python

Duke përdorur Python 3.9+ , instaloni paketën google-genai duke përdorur komandën e mëposhtme pip :

pip install -q -U google-genai

JavaScript

Duke përdorur Node.js v18+ , instaloni SDK-në Google Gen AI për TypeScript dhe JavaScript duke përdorur komandën npm të mëposhtme:

npm install @google/genai

Shko

Instaloni google.golang.org/genai në direktorinë e modulit tuaj duke përdorur komandën go get :

go get google.golang.org/genai

Java

Nëse po përdorni Maven, mund të instaloni google-genai duke shtuar sa vijon në varësitë tuaja:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

Instaloni googleapis/go-genai në direktorinë e modulit tuaj duke përdorur komandën dotnet add.

dotnet add package Google.GenAI

Skripti i Aplikacioneve

  1. Për të krijuar një projekt të ri Apps Script, shkoni te script.new .
  2. Klikoni Projekt pa titull .
  3. Riemërto projektin Apps Script AI Studio dhe kliko Riemërto .
  4. Vendos çelësin tënd API
    1. Në të majtë, klikoni Cilësimet e Projektit Ikona për cilësimet e projektit .
    2. Nën Vetitë e Skriptit, klikoni Shto vetinë e skriptit .
    3. Për Pronën , fut emrin e çelësit: GEMINI_API_KEY .
    4. Për Value , futni vlerën për çelësin API.
    5. Klikoni Ruaj vetitë e skriptit .
  5. Zëvendësoni përmbajtjen e skedarit Code.gs me kodin e mëposhtëm:

Bëni kërkesën tuaj të parë

Ka dy mënyra që mund të përdorni për të dërguar një kërkesë në Gemini API:

  • (Rekomandohet) API-ja e Interactions është një primitiv i ri me mbështetje native për përdorimin e mjeteve me shumë hapa, orkestrimin dhe rrjedhat komplekse të arsyetimit përmes hapave të ekzekutimit të tipizuar. Duke vazhduar më tej, modele të reja përtej familjes kryesore kryesore, së bashku me aftësi dhe mjete të reja agjentike, do të lançohen ekskluzivisht në API-në e Interactions.
  • generateContent ofron një mënyrë për të gjeneruar një përgjigje të thjeshtë, pa gjendje nga një model. Ndërsa ne rekomandojmë përdorimin e Interactions API, generateContent mbështetet plotësisht.

Ky shembull përdor metodën generateContent për të dërguar një kërkesë te Gemini API duke përdorur modelin Gemini 2.5 Flash.

Nëse e vendosni çelësin API si variablin e mjedisit GEMINI_API_KEY , ai do të merret automatikisht nga klienti kur përdoren libraritë Gemini API . Përndryshe, do t'ju duhet ta kaloni çelësin API si argument gjatë inicializimit të klientit.

Vini re se të gjitha mostrat e kodit në dokumentet e Gemini API supozojnë se ju keni vendosur variablin e mjedisit GEMINI_API_KEY .

Python 

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

response = client.models.generate_content(
    model="gemini-3-flash-preview", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript 

import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Shko 

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3-flash-preview",
        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 `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

C# 

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GOOGLE_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

Skripti i Aplikacioneve 

// 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-3-flash-preview:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    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);
}

PUSHTIM 

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Çfarë vjen më pas

Tani që keni bërë kërkesën tuaj të parë API, mund të dëshironi të eksploroni udhëzuesit e mëposhtëm që tregojnë Gemini në veprim: