Migroni në SDK GenAI të Google, Migroni në SDK të GenAI të Google

Duke filluar me lëshimin e Gemini 2.0 në fund të vitit 2024, ne prezantuam një set të ri librarish të quajtur Google GenAI SDK . Ai ofron një përvojë të përmirësuar për zhvilluesit përmes një arkitekture të përditësuar të klientit dhe thjeshton kalimin midis rrjedhave të punës së zhvilluesit dhe ndërmarrjes.

SDK-ja Google GenAI tani është në Disponueshmëri të Përgjithshme (GA) në të gjitha platformat e mbështetura. Nëse po përdorni një nga bibliotekat tona të trashëguara , ne ju rekomandojmë fuqimisht të migroni.

Ky udhëzues ofron shembuj para dhe pas të kodit të migruar për t'ju ndihmuar të filloni.

Instalimi

Para

Python

pip install -U -q "google-generativeai"

JavaScript

npm install @google/generative-ai

Shko

go get github.com/google/generative-ai-go

Java

<dependency>
    <groupId>com.google.ai.client.generativeai</groupId>
    <artifactId>generativeai</artifactId>
    <version>0.9.0</version>
</dependency>

Pas

Python

pip install -U -q "google-genai"

JavaScript

npm install @google/genai

Shko

go get google.golang.org/genai

Java

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

Qasje në API

SDK-ja e vjetër e trajtonte në mënyrë implicite klientin API prapa skenave duke përdorur një sërë metodash ad hoc. Kjo e bënte të vështirë menaxhimin e klientit dhe kredencialeve. Tani, ju bashkëveproni përmes një objekti qendror Client . Ky objekt Client vepron si një pikë e vetme hyrjeje për shërbime të ndryshme API (p.sh., models , chats , files , tunings ), duke promovuar qëndrueshmëri dhe duke thjeshtuar menaxhimin e kredencialeve dhe konfigurimit nëpër thirrje të ndryshme API.

Më parë (Qasje më pak e centralizuar e API-t)

Python

SDK-ja e vjetër nuk përdorte në mënyrë të qartë një objekt klienti të nivelit të lartë për shumicën e thirrjeve API. Ju do të krijonit dhe bashkëvepronit drejtpërdrejt me objektet GenerativeModel .

import google.generativeai as genai

# Directly create and use model objects
model = genai.GenerativeModel('gemini-3.8-flash')
response = model.generate_content(...)
chat = model.start_chat(...)

JavaScript

Ndërsa GoogleGenerativeAI ishte një pikë qendrore për modelet dhe bisedat, funksionalitete të tjera si menaxhimi i skedarëve dhe i memorjes së përkohshme shpesh kërkonin importimin dhe krijimin e klasave të klientëve krejtësisht të ndara.

import { GoogleGenerativeAI } from "@google/generative-ai";
import { GoogleAIFileManager, GoogleAICacheManager } from "@google/generative-ai/server"; // For files/caching

const genAI = new GoogleGenerativeAI("GEMINI_API_KEY");
const fileManager = new GoogleAIFileManager("GEMINI_API_KEY");
const cacheManager = new GoogleAICacheManager("GEMINI_API_KEY");

// Get a model instance, then call methods on it
const model = genAI.getGenerativeModel({ model: "gemini-3.8-flash" });
const result = await model.generateContent(...);
const chat = model.startChat(...);

// Call methods on separate client objects for other services
const uploadedFile = await fileManager.uploadFile(...);
const cache = await cacheManager.create(...);

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import java.util.List;
import java.util.Map;

public class Main {
  public static void main(String[] args) throws Exception {
    Client client = new Client();
    CreateModelInteraction req = CreateModelInteraction.builder()
        .model(Model.of("gemini-3.6-flash"))
        .input(InteractionsInput.of("Hello"))
        .build();
    var interaction = client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
    System.out.println(interaction.outputText().orElse(""));
  }
}

Shko

Funksioni genai.NewClient krijoi një klient, por operacionet e modelit gjenerues zakonisht thirreshin në një instancë të veçantë GenerativeModel të marrë nga ky klient. Shërbime të tjera mund të jenë aksesuar nëpërmjet paketave ose modeleve të dallueshme.

import (
      "github.com/google/generative-ai-go/genai"
      "github.com/google/generative-ai-go/genai/fileman" // For files
      "google.golang.org/api/option"
)

client, err := genai.NewClient(ctx, option.WithAPIKey("GEMINI_API_KEY"))
fileClient, err := fileman.NewClient(ctx, option.WithAPIKey("GEMINI_API_KEY"))

// Get a model instance, then call methods on it
model := client.GenerativeModel("gemini-3.8-flash")
resp, err := model.GenerateContent(...)
cs := model.StartChat()

// Call methods on separate client objects for other services
uploadedFile, err := fileClient.UploadFile(...)

Pas (Objekt i Klientit të Qendruar)

Python

from google import genai

# Create a single client object
client = genai.Client()

# Access API methods through services on the client object
response = client.models.generate_content(...)
chat = client.chats.create(...)
my_file = client.files.upload(...)
tuning_job = client.tunings